# Wheel — tasks

`[x]` done, `[ ]` to do. Questions for Austin are in `DECISIONS.md`. The design is in `PLAN.md`.

## Next up

1. **Austin tries v0.1 on his Android phone, upright and sideways**, installed or in Chrome, with the screen left on for a while, and says what is wrong: sizes, letters too small upright, sounds, colors, the wake lock, the alert times. Anything he reports goes here.
2. Check with Austin that the defaults fit his show: the countdown is named "Wheel of Countdown" and set to 7:30 PM every day (Settings → Countdowns). Is that the right name and time, and should it be weekdays only?
3. Decide the extra views and options Austin wants beyond the four built (see "More views and options" below).
4. Install-as-app test: add to the home screen on Android and check it opens full screen and offline.

## Phase 0: concept (2026-11-04, done)

- [x] Discard the old placeholder (a spin-the-wheel picker for Trudy) and write `README.md`, `CLAUDE.md`, `PLAN.md`, `TASKS.md`, `DECISIONS.md`, `DATA-MODEL.md`.
- [x] Austin answers the first questions (board first, Android phone upright and sideways, countdown to the show as the main purpose, 12-hour clock, more options is better, night and seconds as settings, look mirrors the TV show).

## Phase 1: the clock and the countdown (v0.1, done 2026-11-04)

- [x] Scaffolded from `template/` (app, pwa); storage prefix `wheel.` registered; card picture drawn (`shell/images/thumbs/wheel.svg`).
- [x] Pure modules with unit tests: `clock.js` (daylight saving, midnight, month and year ends, leap day), `layout.js`, `reveal.js`, `events.js`, `alerts.js`, `scenes.js`, `wheelmath.js`, `model.js`.
- [x] Puzzle board of tiles that flip only when a tile changes; category plate; big readout when held upright.
- [x] Countdown to the show with the self-solving puzzle, "IT'S TIME" hold, then the next day.
- [x] Soft alerts at chosen minutes, a tick for the last seconds, the finish (tile wave, wheel spin and landing, flashes, fanfare), synthesized sounds, a "tap to turn sound on" prompt.
- [x] Day wheel: 24 wedges, pegs, flapper, lit rim, hub with the time, gold wedges for countdowns, slow turn, landing spin.
- [x] Four views, control strip, keyboard keys, optional rotation, upright and sideways sizing.
- [x] Settings: countdowns (add, edit, delete with Undo, weekdays, one-offs, puzzle, alerts), alerts, sound, display, look, always-on, backup and restore, reset.
- [x] Always on: wake lock with honest status, full screen, burn-in drift, night dimming (dim or minimal clock) and night silence, redraws by `setTimeout` aimed at the next boundary, offline service worker.
- [x] Unit tests (60) and an end-to-end test (29 checks) with a faked clock and screenshots.

## Phase 2: next improvements

- [ ] Real-device tuning on Android: font choice (the board uses a condensed system font stack), tile and wheel sizes, how bright the white tiles are at night, sound loudness.
- [ ] A visible "last redraw" watchdog on the settings page, to prove the clock is still ticking after hours.
- [ ] Add-to-home-screen prompt and a note on Android's battery settings for the installed app.
- [ ] More than one countdown shown at once (a "next up" list in the corner or on the wheel).
- [ ] Tap-to-edit the featured countdown from the board.

## More views and options (Austin said more is better)

- [ ] A full-screen giant digital countdown view.
- [ ] A "next three" board listing the next three countdowns.
- [ ] More looks (a gold and burgundy set, high contrast).
- [ ] More sound styles and a per-alert sound.
- [ ] Wedges for the next 12 hours instead of the whole day, with labels for the minute.
- [ ] Show the date and weekday on the countdown board when there is room.
- [ ] A second time zone.

## Later

- [ ] Events from a calendar (an ICS link or file).
- [ ] An import of Simple Count Down timers from its exported backup file.
- [ ] A native phone app (the plan from Austin), if the web wake lock proves unreliable; the pure modules are written to be reused.
- [ ] A showcase trailer (`--with showcase` from the template).
- [ ] A spin-to-pick toy mode (the old placeholder's idea) if wanted.
