Superseded decisions
These are kept so the history and the reasons for each change stay visible. Each links to what replaced it.
The dark theme chain: grey-green, teal-lit, true black, solid black
Section titled “The dark theme chain: grey-green, teal-lit, true black, solid black”| Step | Decision | What it was | Replaced by |
|---|---|---|---|
| 1 | Early tokens (before 15 October) | A grey-green dark palette | the DS-8 retune |
| 2 | DS-8 (15 October, 894cf8c) |
Dark tokens retuned for contrast | the teal-lit set |
| 3 | DS-8 (16 October, 5cf062e) |
“Teal-lit” dark: Deep Ink #142C2A page, lit teal panels #193935 and #1F433F, Citron focus |
SW-225 |
| 4 | SW-225 (10 November) | Page goes true black #000, but layers above it stay teal-tinted |
SW-316 |
| 5 | SW-275 and SW-300 addendum (11 November, morning) | Black page with teal-tinted surfaces and borders, desaturated accents | SW-316 |
| 6 | SW-316 (11 November) | One solid black neutral family (current) | nothing |
- DS-8 — Dark token retune, then “teal-lit” dark (15 and 16 October). Why: the first dark values had low contrast in places, so they were retuned, then the dark mode was given a brand look with Deep Ink and Maker Teal surfaces. What went wrong: teal marks were about 1.76:1 on the lit panel, so teal text and charts were too dim and many status pills became dim soft fills. Status: superseded by SW-225, then SW-316.
- Why each step changed: the black page (SW-225) was meant as the smallest change to the teal-lit look,
but putting black next to green-tinted layers made surfaces seam against the page. The morning pass of
11 November kept the tint and had to lift the dark
linejust to make button borders readable (2.97:1). SW-316 then split the roles properly (linefor quiet dividers,outlinefor control edges) and removed every green tint from surfaces.
The font chain: paid Gilroy weights removed
Section titled “The font chain: paid Gilroy weights removed”- SW-31 (18 October) said “Gilroy 400 to 700 with one Unbounded accent per layout”. Superseded by SW-219(a), SW-222 and SW-299: the paid weights (Regular, Medium, SemiBold, Bold) are removed; only Light 300 and ExtraBold 800 ship, with Outfit for everything else. Why: no licence for the paid weights and no plan to buy one (see SW-299).
- SW-128 (28 October) keeps its card-only font-library exception; it was not replaced.
The mascot and banner chain
Section titled “The mascot and banner chain”- SW-55 (keep the Warm Cream card in dark mode) is replaced by SW-56 (a thin sticker border).
- SW-57’s “Patch on the 404 page only” is replaced in part by SW-306 (landing pages under brand rules).
- SW-151 (no mascot on the banner) was refined by SW-152 (only if it looks professional), then settled by SW-168 (Patch peeking from a corner).
- SW-106’s “banner last” was replaced by SW-168 (README now).
Other replaced details
Section titled “Other replaced details”- SW-225 (true black) and SW-219(a) (“dark keeps the shipped palette”) are replaced on their palette values by SW-316.
- SW-277 first said to port the SpaceWorks website’s landing page into the app; its own correction in the same decision says not to copy anything and to build an original page.
- SW-362 (logo opens on hover) was softened by SW-367 (fold shut, then open; no hold).
- DS-1 replaces the earlier README-banner text approach (system-font fallback stack) described in the README changelog.
- The guidelines v1 PDF (15 October) is not superseded; v2 (SW-373) sits beside it. The v1
PDF predates SW-299 and SW-316, and
docs/ui-brand-spec.mdsays so.
Part of Design decisions, with the reason for each, published from docs/decisions.md. Edit it there.