{"id":33319460,"url":"https://github.com/umutozcn/pomodoroaura","last_synced_at":"2026-05-16T09:01:54.794Z","repository":{"id":323267760,"uuid":"1092682539","full_name":"UmutOZCN/PomodoroAura","owner":"UmutOZCN","description":"Stay Focused. Stay Balanced. PomodoroAura helps you manage time with fully customizable Pomodoro cycles and an elegant, distraction-free design.","archived":false,"fork":false,"pushed_at":"2025-11-09T06:13:07.000Z","size":25537,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-09T07:09:09.121Z","etag":null,"topics":["focus","pomodoro","productivity","react","time-management","timer","vercel","webapp"],"latest_commit_sha":null,"homepage":"https://pomodoroaura.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/UmutOZCN.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-09T04:58:05.000Z","updated_at":"2025-11-09T06:28:27.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/UmutOZCN/PomodoroAura","commit_stats":null,"previous_names":["umutozcn/pomodoro-aura"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/UmutOZCN/PomodoroAura","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UmutOZCN%2FPomodoroAura","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UmutOZCN%2FPomodoroAura/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UmutOZCN%2FPomodoroAura/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UmutOZCN%2FPomodoroAura/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/UmutOZCN","download_url":"https://codeload.github.com/UmutOZCN/PomodoroAura/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UmutOZCN%2FPomodoroAura/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":285319005,"owners_count":27151474,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-11-19T02:00:05.673Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["focus","pomodoro","productivity","react","time-management","timer","vercel","webapp"],"created_at":"2025-11-19T20:01:19.960Z","updated_at":"2025-11-19T20:03:06.447Z","avatar_url":"https://github.com/UmutOZCN.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PomodoroAura ⏱️\n\nA **clean and fully customizable Pomodoro timer** designed to help you stay productive and balanced.  \nPomodoroAura 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.\n\n![PomodoroAura Cover](./assets/cover.png)\n\n---\n\n## 🌐 Live Demo\n\nUse PomodoroAura instantly — no installation required:  \n👉 **[Open PomodoroAura](https://pomodoroaura.vercel.app/)**\n\n---\n\n## 🌟 Features\n\n- ⏳ Customizable durations for focus, short break, and long break  \n- 🔁 Adjustable number of sessions before a long break  \n- 🧠 Automatic transitions between focus and break periods  \n- 🛠️ Start, pause, resume, and reset controls  \n- 💾 Local saving of user settings  \n- 🔔 Optional notification sounds  \n- 🌙 Light and dark theme options  \n- 📊 Built-in statistics to track productivity  \n\n---\n\n## 🛠️ Tech Stack \u0026 Key Features\n\nThis project was built from scratch using modern web technologies.\n\n* **Framework:** React 18 (with Hooks)  \n* **Language:** TypeScript  \n* **Build Tool:** Vite  \n* **Styling:** CSS Variables, Grid, Flexbox, Media Queries  \n* **State Management:** Custom `useLocalStorage` hook for all persistent state (settings, timer status, theme, and stats)\n* **Architecture:** A single-page application (SPA) using a modal-based UI to ensure the timer never resets or stops when viewing stats or settings.\n* **Timer Logic:** Relies on \"epoch math\" (Date.now()) for perfect accuracy, even when the browser tab is in the background.\n\n---\n\n## 🧭 How It Works\n\n1. **Set your timer:** Choose your preferred durations for each phase.  \n2. **Select session count:** Decide how many work sessions should trigger a long break.  \n3. **Start focusing:** PomodoroAura automatically manages transitions between focus and breaks.  \n4. **Stay balanced:** Build a healthy and effective workflow.  \n\n---\n\n## 🖼️ Screenshots\n\n| Focus | Short Break | Long Break |\n|-------|--------------|-------------|\n| ![Focus](./assets/screens/focus.png) | ![Short Break](./assets/screens/short-break.png) | ![Long Break](./assets/screens/long-break.png) |\n\n| Settings | Statistics | Light / Dark Theme |\n|-----------|-------------|--------------------|\n| ![Settings](./assets/screens/settings.png) | ![Statistics](./assets/screens/statistics.png) | ![Themes](./assets/screens/themes.png) |\n\n---\n\n## 📬 Contact\n\nFor any questions or feedback, you can reach out via:  \n📧 **umutozcandev@gmail.com**  \nor visit the official website:  \n👉 **[https://pomodoroaura.vercel.app/](https://pomodoroaura.vercel.app/)**  \n\nDeveloped by [@UmutOZCN](https://github.com/UmutOZCN)\n\n## 🔑 License\n\nThis project is licensed under the [MIT License](https://choosealicense.com/licenses/mit/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fumutozcn%2Fpomodoroaura","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fumutozcn%2Fpomodoroaura","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fumutozcn%2Fpomodoroaura/lists"}