# 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. ## Tick rules Listed in `fixtures/orb-rules.json` and restated here: grazers rise with food and fall with low oxygen; bloom rises with light and food and raises waste; filters fall with waste and raise oxygen; food falls as grazers and bloom feed; waste rises with bloom and falls with filters; oxygen slowly follows (1 - waste). Coefficients are in the file. Tests use the file, not a re-typed formula. ## Screenshot tolerance 8 levels, 98% of pixels. ## Inputs | Key | Label | Default | Notes | | --- | --- | --- | --- | | `title` | Title | A glass world | Shown under the orb. | | `seed` | Seed | 5 | A whole number. It pins the starting populations and any later chance. | | `chemistry` | Show chemistry | on | A small set of meters: light, food, waste, oxygen. | | `labels` | Label organisms | off | A hover or a side list of counts. | | `start` | Starting mix | calm | Two shipped starting populations. | ## 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/orb-calm-0.json` | A shipped fixture. The build may move it, but then `design.md` must name the new path. | | `fixtures/orb-calm-48.json` | A shipped fixture. The build may move it, but then `design.md` must name the new path. | | `fixtures/orb-feed.json` | A shipped fixture. The build may move it, but then `design.md` must name the new path. | | `fixtures/orb-rules.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/orb.png` | The glass world at seed 5, population 128, pH 7.2. | ## 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. Seeded ticks change documented populations and chemistry, compared to shipped files at tick 0 and 48, and after a feed tape. Counts never go negative. A golden aquarium frame is checked. No live biology claims and no network.