# 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. ## Dilution fixtures Cases live in `fixtures/dilution.json`. They include: a 1,000,000 raise at 4,000,000 pre-money on 8,000,000 founder shares, pool off, producing the new preferred count and percents; the same raise with a 10% pool refresh first; a second round on top of the first. Percents are reported to 4 decimal places, shares as whole numbers (a fractional share from a pool refresh is floored, leftover assigned to the founder row). ## Payroll trail Start cash 40,000, burn 12,000, no raise: end of month cash is 28,000, 16,000, 4,000, then `missed_payroll` at the start of month 4. File: `fixtures/payroll-short.json`. ## Endings `sale`, `shut_down`, `missed_payroll`, or `still_going` at month 36 (a going-concern end with no sale). Founder proceeds on a sale are `sale_price * founder_shares / total_shares`. ## Screenshot tolerance 8 levels, 98% of pixels. ## Inputs | Key | Label | Default | Notes | | --- | --- | --- | --- | | `company` | Company name | Northbeam | Shown on the cap table and the newspaper. | | `founders` | Founder shares | 8000000 | A whole number, the starting common pool. | | `option_pool` | Refresh the option pool | on | A 10% pool is carved out before a priced round, diluting existing holders. | | `news` | Show a newspaper | on | A one-line headline after each event. | | `script` | Scripted market | calm | The sequence of market events a seed can still shuffle lightly. Tests use a pinned seed. | ## 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/dilution.json` | A shipped fixture. The build may move it, but then `design.md` must name the new path. | | `fixtures/northbeam-calm-7.json` | A shipped fixture. The build may move it, but then `design.md` must name the new path. | | `fixtures/northbeam-choppy-2.json` | A shipped fixture. The build may move it, but then `design.md` must name the new path. | | `fixtures/payroll-short.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/cap-table.png` | Northbeam in round A, quarter 3: runway, payroll, and the cap table. | ## 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. Cap-table and dilution arithmetic is tested to the share and the penny, including an option-pool refresh. A short payroll fixture misses payroll on the documented month. Two scripted games reach a documented sale and a documented shut-down. No live market and no network.