# 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. ## Layout A documented grid (columns, a lead well, a sidebar) in `fixtures/front-layout.json`. The stub places the lead story first, then others in file order. The masthead date format is `3 April 2031` for `2031-04-03` (day month year, no leading zero on day). ## Screenshot tolerance 8 levels, 98% of pixels. Headlines on the page must also match the file exactly. ## Inputs | Key | Label | Default | Notes | | --- | --- | --- | --- | | `title` | Masthead | The Millstead Signal | Shown at the top of the page. | | `date` | Edition date | 2031-04-03 | A frozen date for the edition. Checks use this, not wall-clock today. | | `kicker` | Show kickers | on | A short label above a story. | | `web` | Web density | off | If on, a tighter column; if off, a print-like front page. | | `edition` | Edition | fixture-a | Shipped copy decks. The generator is a stub, not a paid model API. | ## 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/edition-a.json` | A shipped fixture. The build may move it, but then `design.md` must name the new path. | | `fixtures/front-layout.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/mast.png` | The Millstead Signal, 3 April 2031, fixture copy in the lead and the mast. | ## 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. A stubbed generator plus fixture copy produces a page that matches layout goldens and includes every dated item and headline from the file. The edition date is frozen. A fetch hook fails if a paid model or a news host is contacted. No network is required in CI.