Features

• ⏱ Focus / Short Break / Long Break modes (25 min / 5 min / 15 min)
• 🎨 Dark theme with orange accent, smooth animations, and SVG ring countdown
• ▶️ Start, Pause, Reset — plus keyboard shortcuts (Space to toggle, R to reset)
• 🔄 Auto-cycling through the classic Pomodoro sequence
• 🔔 Audio beep at session end (Web Audio API oscillator — no external files)
• 📊 Session counter — pomodoros this cycle and lifetime total
• 📱 Fully responsive — works on mobile and desktop
• 🧹 Zero dependencies — no frameworks, no CDN links, no build step
• 🚀 Ready for GitHub Pages — just push and enable

How It Works

flowchart TD
    Start(( )) --> Focus[Focus 25min]
    Focus -->|Session Complete| ShortBreak[Short Break 5min]
    ShortBreak --> Focus
    Focus -->|4th cycle| LongBreak[Long Break 15min]
    LongBreak --> Focus
    Focus -->|Auto-start| SB[Next break or focus]
    SB --> Focus

The timer follows the classic Pomodoro Technique:

1. Work for 25 minutes (Focus)
2. Take a 5 minute short break
3. Repeat 3 more times
4. After the 4th focus session, take a 15 minute long break
5. Repeat the cycle

Sessions auto-advance with an audible beep and optional desktop notification.

Getting Started

Local

Just open index.html in any modern browser:

open index.html

GitHub Pages

1. Fork or copy this repository
2. Push to https://github.com/soumendrak/pomodoro
3. In the repo Settings → Pages, select main branch and / (root) folder
4. Visit https://soumendrak.github.io/pomodoro/

Keyboard Shortcuts

License

Licensed under the MIT License.