An interval timer for round-based training: boxing, HIIT, circuits. Work a round, rest, repeat, with a lead-in to get set and a bell on every transition so you can keep your eyes off the screen.
It runs in the browser and installs as a PWA. Once loaded it works offline, keeps the screen awake while a session runs, and caches its own sounds.
Live at ymainier.github.io/timer.
A session is one preparation lead-in followed by rounds that cycle until you stop:
Preparation → Round 1 → Rest → Round 2 → Rest → Round 3 → ...
There's no fixed round count. The timer loops round-then-rest forever, numbering each round as it goes. You adjust three durations in Settings: round, rest, and the alarm window (the last stretch of a round). Preparation is fixed. Defaults are a 10-second prep, 3-minute rounds, 1-minute rests, and a 30-second alarm.
Optionally, give each round something to do. Settings has one textarea where you write the whole workout as a markdown list — one line per round, numbered or bulleted or bare:
1. jab-cross-hook, jab-cross-slip-teep
2. non-stop kicksThe first line is round 1, the next is round 2, and so on; the marker and number are cosmetic, and blank lines are skipped. What you write shows below the countdown: the current round's line during the round, and the next round's as "Next up" during the rest before it (preparation previews round 1). Lines take inline **bold** and *italic* markdown, nothing else.
The routine is a plain annotation with no timing of its own — rounds keep their single fixed duration. Once the list runs out the timer keeps looping unlabeled. Leave it empty and the timer behaves exactly as it did before. Like the durations, a routine isn't persisted yet — it resets on reload.
Three sounds mark what's happening:
- Bell on every phase change: prep into round, round into rest, rest into round.
- Knocks when a round drops into its alarm window, so you know it's almost over.
- Snap on each of the last few prep seconds, counting you in.
npm install
npm run dev # dev server with hot reload
npm test # Vitest, watch mode
npm run build # type-check and bundle to dist/
npm run preview # serve the production buildRequires Node 24 (matching CI). The build type-checks with tsc -b before Vite bundles, so a type error fails the build.
React 19, Vite, Tailwind, TypeScript. The timing logic is a small pure core with the UI kept at the edges.
src/core/roundTimer.ts— a reducer over one elapsedduration, plusread(), which derives the current phase, remaining time, and round number from that single number. All the round/rest looping is modular arithmetic here, no wall-clock branching.src/core/soundCues.ts—soundCues(prev, next)compares two states and returns why a sound should fire (phase-changed,entered-alarm,prep-countdown), named in the timer's own terms. It never touches audio.src/hooks/useRoundTimer.ts— drives the reducer on a 100ms tick, holds the screen wake lock, and maps cues to actual<audio>playback.src/core/routine.ts— the routine as the raw markdown text you typed, plusparseRoutine()splitting it into one line per round anddisplayedExercises()deriving what to show from the current phase and round. It stays out of the timer core deliberately (seedocs/adr/0001-routine-outside-timer-core.md): it's timing-free annotation, so it lives inAppstate and is looked up by round number, never threaded through the reducer.src/lib/inlineMarkdown.ts— a tiny inline-markdown parser for round lines, bold and italic only. Everything else, raw HTML included, stays literal text.
Keeping cues separate from playback means the core is testable without a DOM or a speaker. The cue logic, the reducer, and time formatting all have unit tests next to them.
CONTEXT.md— the domain vocabulary. Phase, Round, Rest, Alarm, Cue, Config, Exercise, and Routine have precise meanings here; the code uses these words deliberately.docs/adr/— architecture decision records, e.g. why the routine stays out of the timer core.docs/agents/— conventions for the issue tracker and domain docs used when working with coding agents.
Pushing to main builds and deploys to GitHub Pages via .github/workflows. The app is served under /timer/, set as Vite's base.