{"id":20612849,"url":"https://github.com/marinoffdev/focus-fox","last_synced_at":"2026-04-15T05:31:34.049Z","repository":{"id":240792839,"uuid":"802299019","full_name":"marinoffDev/Focus-Fox","owner":"marinoffDev","description":"Pomodoro technique-based focus timer that helps you stay in a flow state. 🦊💻","archived":false,"fork":false,"pushed_at":"2025-05-28T21:37:56.000Z","size":3526,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-22T20:47:01.906Z","etag":null,"topics":["focus","javascript","nodejs","pomodoro","pomodoro-technique","pomodoro-timer","productivity","productivity-tools","react","react-router-dom","shadcn-ui","tailwindcss","time-management","timer","vite","web-application","webapp"],"latest_commit_sha":null,"homepage":"https://marinoffdev.github.io/Focus-Fox/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/marinoffDev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":"marinoffDev","patreon":null,"open_collective":null,"ko_fi":"marinoffdev","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2024-05-17T23:41:29.000Z","updated_at":"2025-05-28T21:37:33.000Z","dependencies_parsed_at":null,"dependency_job_id":"8c995ce7-ab60-4f70-ad1c-b0ff104f96a6","html_url":"https://github.com/marinoffDev/Focus-Fox","commit_stats":null,"previous_names":["marinoffdev/focus-fox"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/marinoffDev/Focus-Fox","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marinoffDev%2FFocus-Fox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marinoffDev%2FFocus-Fox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marinoffDev%2FFocus-Fox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marinoffDev%2FFocus-Fox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/marinoffDev","download_url":"https://codeload.github.com/marinoffDev/Focus-Fox/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marinoffDev%2FFocus-Fox/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31828530,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T18:05:02.291Z","status":"online","status_checked_at":"2026-04-15T02:00:06.175Z","response_time":63,"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","javascript","nodejs","pomodoro","pomodoro-technique","pomodoro-timer","productivity","productivity-tools","react","react-router-dom","shadcn-ui","tailwindcss","time-management","timer","vite","web-application","webapp"],"created_at":"2024-11-16T11:08:04.716Z","updated_at":"2026-04-15T05:31:34.030Z","avatar_url":"https://github.com/marinoffDev.png","language":"JavaScript","funding_links":["https://github.com/sponsors/marinoffDev","https://ko-fi.com/marinoffdev"],"categories":[],"sub_categories":[],"readme":"\n\u003cdiv align=\"center\"\u003e\n  \u003ch1 style=\"font-weight: 800;\"\u003eFocus Fox\u003c/h1\u003e\n  \u003ch2 style=\"font-size: 1.2rem; font-weight: 600; font-style=\"italic\"\u003eYour Go-To Online Timer for Enhanced Productivity\u003c/h2\u003e\n  \u003ca href=\"https://marinoffdev.github.io/Focus-Fox/\" target=\"_blank\"\u003e\n    \u003cimg alt=\"Focus Fox web app screenshot\" src=\"https://raw.githubusercontent.com/marinoffDev/Focus-Fox/refs/heads/main/public/screenshot.jpg\" width=\"770px\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n---\n## Table of Contents\n- [🔍 Overview](#-overview)\n- [🌐 Live Demo](#-live-demo)\n- [🚀 Features](#-features)\n- [🤔 How to Use the Focus Fox Timer](#-how-to-use-the-focus-fox-timer)\n- [🛠 Technologies Used](#-technologies-used)\n- [💻 Installation](#-installation)\n- [🚧 Roadmap](#-roadmap)\n- [🤝 Contributing](#-contributing)\n- [📄 License](#-license)\n---\n\n## 🔍 Overview \n**Focus Fox** is an open-source Pomodoro timer web app designed to help boost productivity through structured work and break sessions. It supports customizable timer lengths for Pomodoro sessions, short breaks, and long breaks.\nThis project is still in its early stages, so feedback and contributions are welcome and appreciated!\n\n## 🌐 Live Demo \nCheck out the live version here: **[Focus Fox](https://marinoffdev.github.io/Focus-Fox/)**\n\n## 🚀 Features\n- **Pomodoro Timer**: Focus on tasks in timed intervals (work/break cycles a.k.a. rounds).\n- **Customizable Timers**: Adjust durations for Pomodoro, Short Breaks, Long Breaks and auto-start behavior to suit your preferences.\n- **Notifications**: Get browser notifications when a timer expires with customizable sounds.\n- **Mobile Responsive**: Works smoothly across desktop and mobile devices.\n- **Dark/Light Mode**: Toggle between dark and light themes.\n- **Accessible \u0026 Minimalist Design**: Simple UI that helps you stay focused.\n\n## 🤔 How to Use the Focus Fox Timer\n1. Customize the timer settings to fit your preferences.\n2. Choose a task to focus on.\n3. Start the Pomodoro timer and concentrate solely on your task for the set duration (default: 25 minutes).\n4. Take a short break after each Pomodoro (default: 5 minutes).\n5. After several Pomodoros, opt for a longer break (default: 15 minutes after every 4 rounds).\n6. Repeat steps 3-5 until all your tasks are completed.\n\nIf you would like to learn more about the Pomodoro technique you can read about it [here](https://en.wikipedia.org/wiki/Pomodoro_Technique).\n\n## 🛠 Technologies Used\n- React for building dynamic UI components.\n- React Router for page navigation.\n- Vite for fast development and build tooling.\n- Tailwind CSS (with ShadCN/UI) for utility-first styling and component library.\n- FontAwesome for icons.\n\n## 💻 Installation\nTo run this project locally:\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/marinoffDev/Focus-Fox.git\n```\n\n2. Navigate to the project directory:\n```bash\ncd Focus-Fox\n```\n\n3. Install the dependencies:\n```bash\nnpm install\n```\n\n4. Start the development server:\n```bash\nnpm run dev\n```\n\n## 🚧 Roadmap\nFuture plans for enhancements and development:\n- [x] Add page routes for Privacy Policy, Terms and Conditions, and 404 Page Not Found\n- [x] Add a sitemap.xml, robots.txt and meta tags\n- [x] Add a customization option for number of pomodoro rounds before a long break (currently default is 4)\n- [x] Add an option to reset all user customizations preferences back to default\n- [x] Add more notification sound options\n- [x] Add open graph meta tags\n- [x] Add an option to enable browser notifications\n- [x] Add browser cookies support to store the user's customization preferences\n- [x] Add an option to start subsequent timers automatically\n- [x] Add a component that provides user feedback when their custom preferences have been applied\n- [x] Add volume controls for the notification sound\n- [x] Add more theme customization options\n- [x] Add a toggle for \"super dark mode\" while a timer is active\n\n## 🤝 Contributing\nContributions are welcome!\n\nHere's how you can contribute:\n\n1. **Submit an Issue**: If you encounter a bug or have a feature request, please submit a [GitHub issue](https://github.com/marinoffDev/Focus-Fox/issues) first. This helps us discuss your suggestions before you begin working on it.\n2. **Fork the Repository**: After an issue has been submitted, feel free to fork this repository and work on a fix or enhancement.\n3. **Open a Pull Request**: Once your changes are ready, open a pull request (PR). Please reference the issue number and describe the changes you made.\n\n## 📄 License\n**Focus Fox** is licensed under the **CC BY-NC 4.0** License - see the [LICENSE](https://github.com/marinoffDev/Focus-Fox/blob/main/LICENSE) file for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarinoffdev%2Ffocus-fox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarinoffdev%2Ffocus-fox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarinoffdev%2Ffocus-fox/lists"}