Promodoro �⏲️

A simple and elegant Pomodoro Timer built with Joy UI, react-timer-hook, and Next.js 15 to boost your productivity.

---

Features ✨

• Pomodoro Technique: 25-minute work sessions followed by 5-minute breaks.
• Customizable Durations: Adjust work/break times in settings.
• Responsive Design: Works seamlessly on desktop and mobile.
• Sound Notifications: Gentle alerts when a session ends.
• Pause/Resume: Full control over your timer.
• Progress Indicator: Visual feedback for time remaining.

Installation 🛠️

1. Clone the repository:

   git clone https://github.com/your-username/promodoro.git

2. Install dependencies: bun install
3. Run the development server: bun run dev

Usage 🎮

1. Set durations: Click the settings icon to adjust work/break times.
2. Start timer: Click "Start" to begin your focus session.
3. Take breaks: The timer automatically switches between work and break modes.
4. Reset: Click "Reset" to return to default settings.

Built With 🧰

• ⚛️ Next.js 15 (App Router)
• 🎨 Joy UI for sleek and modern components
• ⏱️ react-timer-hook for timer logic
• 🔋 TypeScript
• 🚀 Deployed on Vercel

Contributing 🤝

Contributions are welcome!

1. Fork the project.
2. Create a feature branch (git checkout -b feat/amazing-feature).
3. Commit changes (git commit -m 'Add amazing feature').
4. Push to the branch (git push origin feat/amazing-feature).
5. Open a Pull Request.

License 📄

This project is licensed under the MIT License. See LICENSE for details.

Acknowledgments 🙌

• react-timer-hook for robust timer logic
• Joy UI for beautiful React components

🌍 Live Preview: https://simple-tomato-timer.vercel.app/

⭐ Star this repo if you found it useful!