# Color Timer — tasks

The live checklist for this tool. `[x]` done, `[ ]` to do. Open questions for Austin are in `DECISIONS.md`. Keep "Next up" current: it is the first thing the next person (or agent) reads, so it should say what to do next and why, in order.

## Next up

1. Austin: try v0.2 on the phone and in the browser, and answer the open questions in `DECISIONS.md`: which of the four time-since looks to keep (pulsing stripes, soft solid, pulsing, blinking), whether 15 seconds is the right default for dimming, which alarm sound and effects you want on by default, and which way the colour fills.
2. Make it installable and offline (a `manifest.webmanifest` and a service worker; `template/` has the `pwa` extra). A timer you leave on a phone should keep working without a connection.
3. Check how it behaves on a locked phone: the chime and the vibration can be late or missing when the browser has paused the page (see `LEARNINGS.md`). If that matters in daily use, the answer may be a notification or a native app, not more web code.
4. Optional polish: a fill-direction setting, a "+1 min" nudge button, and a few named favourites (for example "Tea 4:00").

## Phase 1: first working version (done 2026-11-05)

- [x] Scaffolded from the toolbox `template/` (folder, `meta.json`, docs, tests, thumbnail, storage registry entry).
- [x] The dial: coloured wedge from 12 clockwise to the minute hand, 60-minute circle, minute numbers, a hand with a knob.
- [x] Set it by tapping the dial, dragging the hand (it stops at the top instead of jumping across), the keyboard (arrows, Page Up and Down, Home and End), or quick-set chips.
- [x] Set it by typing a duration (`25`, `1h30`, `90s`, `5:00`) or a target time (`3:45pm`, `15:45`, `noon`), with a live preview of what was understood.
- [x] Start, pause, resume, reset and run again; a running timer keeps its end time across a reload; dragging the hand while it runs re-sets the end.
- [x] Shifting colour (green, yellow, red) or a fixed colour; minute numbers on or off.
- [x] Chime and vibration at the end, countdown in the tab title, screen kept awake while it runs.
- [x] Saved data goes through one normalizer and survives a reload (see `CLAUDE.md`, data rules).
- [x] Backup and restore work.
- [x] Unit tests pass, and the end-to-end smoke test passes with the screenshots looked at (phone and desktop, light and dark).
- [x] `meta.json` filled in properly: description, `features`, `roadmap`, `storage` note, real dates.
- [x] Every template placeholder is filled in (`node template/audit.mjs color-timer` lists any that are left).

## Version 0.2 (done 2026-11-05)

- [x] The minute hand carries on past 12 when time is up, sweeping back round, and the space it passes is shaded in a pink no countdown colour uses; a quiet "+m:ss past the end" counts the time since; "Time's up" and the red 0:00 stay. The end time is saved as `endedAt`, so it is right after a reload and in a hidden tab.
- [x] Four looks for the time since to try: pulsing stripes (default), soft solid, solid pulsing, solid blinking. Reduced motion keeps the shading and drops the movement.
- [x] Side margins narrowed (8px; the dial is nearly the full width on a phone) and the dial can be a little larger on desktop.
- [x] Full-screen view: button, F key, Escape to leave; nothing but the dial, the time and the buttons; side by side on a wide screen; a plain full-window layout where the browser has no full screen (iPhone).
- [x] Dim when idle: after 5 seconds to 2 minutes without a touch (15 seconds by default, or never), everything except the timer dims; any touch, move or key brings it back, and so does the alarm going off.
- [x] Five alarm sounds (soft beeps, bell, marimba, rising notes, digital), preview on choosing, repeat once, four times or until stopped (up to 30 minutes), and a Stop the sound button that keeps the time since on screen.
- [x] More end effects as options: rings across the dial, soft colour flashes, vibration, flashing tab title while hidden, and a notification while hidden. "Try the alarm" shows them without starting a timer.
- [x] 31 unit tests and 42 browser checks pass; a duplicate-id bug found by the browser test is fixed and guarded against.

## Phase 2: make it good

- [ ] Installable and offline (see Next up).
- [ ] Fill direction setting (the wedge growing instead of shrinking, or filling the other way round).
- [ ] Timers longer than an hour show their extra laps (a small count of full turns) instead of a dial that stays full until the last hour. The same goes for the time since, which holds at a full dial after an hour.
- [ ] A volume control for the alarm, and a choice of colour for the time since.
- [ ] Keep the alarm going when the phone is locked (needs a notification or a native app; see Next up).
- [ ] More than one timer at once.

## Later ideas

- [ ] A "Time Timer" style big-number-free mode for children and for presenting (hide the readout, keep the dial).
- [ ] Remember full screen across a reload (browsers only allow real full screen after a tap, so this could only restore the layout).
- [ ] Share a timer by link (`#25` or `#until=15:45`).
- [ ] A hand-off to Simple Count Down and Wheel (a link to start the same countdown there).
