How to Use
Press the play button or hit Space to start a 25-minute focus session. When the timer ends, you'll hear a chime and get a short break. After four focus sessions, enjoy a longer break. The cycle then repeats.
Use the text field at the top to label what you're working on. This keeps you focused and shows in browser notifications when a session ends.
Session Cycle
- Focus (25 min default) — Concentrate on a single task
- Short Break (5 min default) — Quick rest between sessions
- Long Break (15 min default) — Extended rest after 4 focus sessions
The four dots below the timer track your progress through each cycle. Completing all four earns a confetti celebration!
Controls
- Play / Pause — Start or pause the timer (keyboard: Space)
- Skip — Jump to the next session (keyboard: S)
- Reset — Reset the current session to full time (keyboard: R)
Settings
Click the gear icon to customize:
- Session durations — Set custom minutes for focus, short break, and long break
- Auto-start — Automatically begin the next session when one ends
- Notifications — Get browser notifications when sessions complete
- Sound — Toggle the completion chime on or off
Tab Timer
While a session is running, the browser tab shows the countdown and a dynamic favicon with a progress ring. This lets you monitor your timer even while working in other tabs.
Statistics
Your progress is tracked automatically and stored locally in your browser. The stats bar shows today's sessions, total focus minutes, your daily streak, and personal best. Click the chart icon for a detailed breakdown including full cycles completed.
Frequently Asked Questions
What is the Pomodoro Technique?
The Pomodoro Technique is a time management method developed by Francesco Cirillo in the late 1980s. It uses timed intervals of focused work (typically 25 minutes) separated by short breaks to improve concentration and prevent burnout.
Can I customize the session durations?
Yes. Click the gear icon to set custom durations for focus sessions, short breaks, and long breaks. Changes take effect from the next session.
Will I get notified when a session ends?
Yes, if you enable notifications in settings. The timer also plays a chime sound and the browser tab displays a countdown so you can monitor it from other tabs.
Are my productivity stats saved?
Yes. Your daily session count, total focus minutes, daily streak, and personal best are tracked automatically and stored locally in your browser.
What keyboard shortcuts are available?
Press Space to play or pause the timer, S to skip to the next session, and R to reset the current session to its full duration.
About the Pomodoro Technique
The Pomodoro Technique is a time management method developed by Francesco Cirillo in the late 1980s. It uses timed intervals of focused work separated by short breaks to improve concentration and prevent burnout. The name comes from the tomato-shaped kitchen timer Cirillo used as a university student.
The basic idea: work with full focus for a set period, then reward yourself with a break. After several cycles, take a longer break to recharge. It's simple, effective, and requires nothing more than a timer.
From the build: the timer is anchored to `Date.now()` instead of being driven by a setInterval tick, because background tabs throttle intervals and we wanted the countdown to be correct when you come back. The favicon ring is drawn to a 32x32 canvas on every minute boundary and swapped onto the tab via a data-URI — cheap, and it means you get an actual progress indicator in the tab strip without a separate window. Notifications use the Web Notification API only after the user explicitly enables them in settings; we never prompt automatically.