⏱️ FlowState Focus Timer

A premium, minimalist Pomodoro-style productivity timer built as a Chrome Extension. Designed for deep work, FlowState helps you manage your time with elegant visuals and local-only data persistence.

✨ Features

• 🎯 Session Management: Toggle between Deep Work (25m), Short Breaks (5m), and Long Breaks (15m).
• 📝 Multi-Level Goals: Organize your tasks into Today, Weekly, and Monthly lists.
• 🔄 Smart Pickups: Easily move items from your long-term lists into your daily focus.
• 📊 Detailed Analytics: Track your focus patterns with a 7-day bar chart and session history.
• 🔥 Persistence: All data is stored locally in your browser (no cloud or database required).
• 🌿 Wellness Reminders: Get randomized, science-backed break suggestions (stretches, hydration, eye rest) after each session.
• 🔔 Desktop Notifications: Stay informed with badge-text countdowns and system notifications when sessions end.

🚀 Installation

1. Clone this repository:

   git clone https://github.com/fahadmustjab/FlowState.git

2. Open Chrome and navigate to chrome://extensions/.
3. Enable Developer mode (toggle in the top right).
4. Click Load unpacked and select the project directory.

🛠️ Built With

• Chrome Extension API (Manifest V3): Leveraging modern service workers and storage.
• Vanilla JavaScript & CSS3: No heavy frameworks, just pure performance and custom glassmorphism styling.
• Alarms API: Ensuring reliable timing even when the popup is closed.

🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

👤 Author

Developed with ❤️ by Fahad Mustjab (@fahadmustjab)

📄 License

Distributed under the MIT License. See LICENSE for more information.