# 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. ## Millstead scale 40 pixels are 10 metres (0.25 m/px). Harbour's scale is in its folder. ## Fixture guesses (millstead, seed 3, round 1) Place: "The old post office", true point in the places file. Guess offset and expected metres and score are in `fixtures/millstead-round-1.json`. The five-round tape and the final score are `fixtures/millstead-tape.json`. ## Screenshot tolerance 8 levels, 98% of pixels. ## Inputs | Key | Label | Default | Notes | | --- | --- | --- | --- | | `title` | Title | Do you know these streets? | Shown above the map. | | `rounds` | Rounds in a game | 5 | From 3 to 10. | | `timer` | Time each round | on | A 20-second timer. Tests inject the clock. | | `metric` | Show distances in metres | on | If off, distances are shown in a rounded 'minutes' walk, still computed from metres. | | `city` | Fixture city | millstead | A shipped tileset and a list of places. No live map provider. | ## 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 | | --- | --- | | `design.md` | A shipped fixture. The build may move it, but then `design.md` must name the new path. | | `fixtures/millstead-round-1.json` | A shipped fixture. The build may move it, but then `design.md` must name the new path. | | `fixtures/millstead-seed-3.json` | A shipped fixture. The build may move it, but then `design.md` must name the new path. | | `fixtures/millstead-tape.json` | A shipped fixture. The build may move it, but then `design.md` must name the new path. | | `places.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/map.png` | Round two of the street quiz, a pin near the old mill bridge. | ## 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. Scoring is tested against a fixture tileset and place list. Checks hook network calls so a live map API cannot sneak in. Guessed versus actual distances match the fixture file, and a golden round is screenshotted. The clock is injected. No GPS and no commercial map key.