Skip to content

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 line just to make button borders readable (2.97:1). SW-316 then split the roles properly (line for quiet dividers, outline for 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.
  • 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).
  • 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.md says so.

Part of Design decisions, with the reason for each, published from docs/decisions.md. Edit it there.