# Design This file fixes the parts that are easy to get wrong. The language and tools are up to you, as long as the numbers here hold. ## Classic timings Prepare `prepare` seconds, then 12 cycles of 30 s work and 10 s rest, except there is no rest after the last move. The file is the authority for names and for the mid-move screenshot's time (start of move 6). ## Screenshot tolerance 8 levels, 98% of pixels. The on-screen remaining time must also match the injected clock. ## Inputs | Key | Label | Default | Notes | | --- | --- | --- | --- | | `title` | Title | Seven minutes | Shown at the start. | | `prepare` | Prepare, seconds | 5 | A countdown before the first move, from 0 to 10. | | `beep` | Beep on a change | on | Tests may mock audio and only assert that a beep was requested. | | `hold` | Allow a pause | on | A control pauses the injected clock's effect on the routine. | | `routine` | Routine | classic | classic is 12 moves, 30 seconds each, 10 seconds of rest. short is 4 moves, for quicker checks. | ## Acceptance at the defaults The numbers, names and fixture paths already in this file are the authority. Where a later table or a shipped fixture file disagrees with prose, the table or the fixture wins. | Fixture | Role | | --- | --- | | `fixtures/routine-classic.json` | A shipped fixture. The build may move it, but then `design.md` must name the new path. | | `spekkr.inputs.json` | A shipped fixture. The build may move it, but then `design.md` must name the new path. | Golden frames are compared at 1400 by 1000 CSS pixels unless a requirement names another size. Tolerance, unless a tighter figure is given above: 8 levels, 98% of pixels, with motion, cursors and clocks frozen as this file says. A build's goldens are of that build; they do not have to match a shipped reference preview pixel-for-pixel if the tool or the type is different, but they do have to match this file's layout, counts and copy. ## Screenshots These pictures are headless-Chrome captures of the working reference in `reference/preview.html`, at the default inputs. They are not drawings of a product that has not been built. The first picture is the one Spekkr shows on the spec's card. A build may ship its own goldens; those goldens are of that build and do not have to match these frames pixel-for-pixel. | File | What it shows | | --- | --- | | `shots/squat.png` | Twenty-two seconds into squat, after a five-second prepare, on a fake clock. | ## How to verify 1. Run the checks at the default inputs, without a network. 2. Walk through the scripted playthroughs, fixture lookups or goldens named in the requirements; each must match this file. 3. Repeat once at the person's inputs when they differ from the defaults. 4. Exercise order and durations are tested with a fake clock against a fixture table, including rest and a pause. A golden mid-routine screenshot is checked. Audio may be mocked. No camera, no sensor, and no network.