https://github.com/umutozcn/pomodoroaura

Stay Focused. Stay Balanced. PomodoroAura helps you manage time with fully customizable Pomodoro cycles and an elegant, distraction-free design.
https://github.com/umutozcn/pomodoroaura

focus pomodoro productivity react time-management timer vercel webapp

Last synced: about 1 month ago
JSON representation

Stay Focused. Stay Balanced. PomodoroAura helps you manage time with fully customizable Pomodoro cycles and an elegant, distraction-free design.

• Host: GitHub
• URL: https://github.com/umutozcn/pomodoroaura
• Owner: UmutOZCN
• License: mit
• Created: 2025-11-09T04:58:05.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2025-11-09T06:13:07.000Z (8 months ago)
• Last Synced: 2025-11-09T07:09:09.121Z (8 months ago)
• Topics: focus, pomodoro, productivity, react, time-management, timer, vercel, webapp
• Language: TypeScript
• Homepage: https://pomodoroaura.vercel.app
• Size: 24.4 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# PomodoroAura ⏱️

A **clean and fully customizable Pomodoro timer** designed to help you stay productive and balanced.  

PomodoroAura allows you to **set your own focus, short break, and long break durations**, as well as **define how many focus sessions** are needed before a long break begins.

![PomodoroAura Cover](./assets/cover.png)

---

## 🌐 Live Demo

Use PomodoroAura instantly — no installation required:  

👉 **[Open PomodoroAura](https://pomodoroaura.vercel.app/)**

---

## 🌟 Features

- ⏳ Customizable durations for focus, short break, and long break  

- 🔁 Adjustable number of sessions before a long break  

- 🧠 Automatic transitions between focus and break periods  

- 🛠️ Start, pause, resume, and reset controls  

- 💾 Local saving of user settings  

- 🔔 Optional notification sounds  

- 🌙 Light and dark theme options  

- 📊 Built-in statistics to track productivity  

---

## 🛠️ Tech Stack & Key Features

This project was built from scratch using modern web technologies.

* **Framework:** React 18 (with Hooks)  

* **Language:** TypeScript  

* **Build Tool:** Vite  

* **Styling:** CSS Variables, Grid, Flexbox, Media Queries  

* **State Management:** Custom `useLocalStorage` hook for all persistent state (settings, timer status, theme, and stats)

* **Architecture:** A single-page application (SPA) using a modal-based UI to ensure the timer never resets or stops when viewing stats or settings.

* **Timer Logic:** Relies on "epoch math" (Date.now()) for perfect accuracy, even when the browser tab is in the background.

---

## 🧭 How It Works

1. **Set your timer:** Choose your preferred durations for each phase.  

2. **Select session count:** Decide how many work sessions should trigger a long break.  

3. **Start focusing:** PomodoroAura automatically manages transitions between focus and breaks.  

4. **Stay balanced:** Build a healthy and effective workflow.  

---

## 🖼️ Screenshots

| Focus | Short Break | Long Break |

|-------|--------------|-------------|

| ![Focus](./assets/screens/focus.png) | ![Short Break](./assets/screens/short-break.png) | ![Long Break](./assets/screens/long-break.png) |

| Settings | Statistics | Light / Dark Theme |

|-----------|-------------|--------------------|

| ![Settings](./assets/screens/settings.png) | ![Statistics](./assets/screens/statistics.png) | ![Themes](./assets/screens/themes.png) |

---

## 📬 Contact

For any questions or feedback, you can reach out via:  

📧 **umutozcandev@gmail.com**  

or visit the official website:  

👉 **[https://pomodoroaura.vercel.app/](https://pomodoroaura.vercel.app/)**  

Developed by [@UmutOZCN](https://github.com/UmutOZCN)

## 🔑 License

This project is licensed under the [MIT License](https://choosealicense.com/licenses/mit/).