A cute, modern Pomodoro timer to help you focus better.
✨ Try it live | 📖 Technical Docs
Pomotan is a clean, distraction-free Pomodoro timer that helps you stay focused using the proven time management technique. Built with React and designed with care, it offers customizable sessions, beautiful themes, and everything stays on your device.
- Three session types: Focus, short breaks, and long breaks
- Customizable durations: 1-60 minutes for focus/long breaks, 1-30 minutes for short breaks
- Visual progress bar showing completion percentage
- Session counter tracking your progress
- Auto-start countdown with smooth transitions between sessions
- Smart reset options: Reset current timer or reset everything including session count
- 7 beautiful themes: Sunset, Midnight, Matcha, Snow, Mono, Periwinkle, and Bloom
- Persistent settings: All preferences saved locally
- Configurable long break interval: Choose after how many sessions (2-8)
- Sound notifications: Different sounds for focus and break endings
- Toggle auto-start: Optional 3-second countdown between sessions
- Picture-in-Picture mode: Floating mini player (Chrome/Edge 116+)
- Dynamic tab title: See timer countdown from any tab
- Toast notifications: Friendly, encouraging messages
- Fully responsive: Works beautifully on desktop, tablet, and mobile
- Smooth animations: Polished transitions throughout
- No tracking, no ads, no accounts
- Everything stays on your device
- Works offline
- Open source
Visit pomotan.vercel.app - no installation needed!
-
Clone the repository
git clone https://github.com/AmazingDude/pomodoro-app.git cd pomodoro-app/client -
Install dependencies
npm install
-
Start the development server
npm run dev
-
Open in browser
http://localhost:5173
- React 19 - UI library
- Vite - Build tool
- Tailwind CSS 4 - Styling
- Radix UI - Accessible components
- Lucide React - Icons
- Sonner - Toast notifications
I wanted to build a Pomodoro timer for a long time, and I finally did it! Unlike other timers cluttered with features, Pomotan focuses on what matters:
- Simple and beautiful - No distractions, just a timer
- No backend needed - Everything works locally in your browser
- Actually useful - Thoughtful features like PiP mode and session persistence
Got suggestions or found a bug? Open an issue on GitHub!
This project is licensed under the MIT License - see the LICENSE file for details.
- Live Demo: pomotan.vercel.app
- GitHub: github.com/AmazingDude/pomodoro-app
- Technical Documentation: TECHNICAL.md
This project is dedicated to everyone striving to focus better in an increasingly distracting world. Happy focusing! ✨