Skip to content
v2.1

Design decisions

This file keeps every decision that shapes how Space Works looks, moves and is built, together with the reason behind it, so the reason is not lost when the people involved move on.

How to read it:

  • SW-nnn is the number of the decision in the SpaceWorks decisions ledger (the main product’s record of everything the owner decided). The numbers match, so you can look the decision up there for the full text. A later decision wins over an earlier one; replaced decisions are listed again under Superseded decisions and are never deleted.
  • DS-n is a decision that belongs only to this design repository and has no ledger number.
  • “The owner” is the project owner. Quotes are the owner’s own words from the ledger.
  • Where the ledger or the commit history gives no reason, the entry says Reason not recorded rather than guessing.
  • Dates are 2026. App paths (for example frontend/src/index.css) point into the main SpaceWorks repository; every other path is in this repository.
  • Written 13 November 2026, covering decisions up to SW-385.

Index

Section titled “Index”
Number Title Status
SW-385 Design site v2.0: grouped sections, long pages split, wide layout current
SW-383 Pipelines, versions and releases page (docs/delivery.md) current
SW-382 This release is “Space Works Design System v2.0” current
SW-381 Logo box animation: one orange face when shut, no holes in dark, frame-checked current
SW-380 One bright chart palette in light and dark; contrast from edges current
SW-379 Push to main now; every change ships with tests; this decisions file current
SW-378 Search field animation current (template in progress)
SW-377 Every animation becomes a reusable template current (in progress)
SW-376 Theme-switch animation as a template current
SW-375 Org-wide rules: hybrid per part, mobile analytics SDKs current
SW-374 Rename to SpaceWorks-Design-System; dev, then PR, then main; owner-only commits current
SW-373 Brand guidelines v2 current
SW-372 README banner with rounded corners and the logo current
DS-1 Banner text is outlined, not live fonts current
SW-371 Preview freshness check current
SW-370 Design images follow the new palette current (screenshots in progress)
SW-369 Product rules apply to every SpaceWorks-Labs product current
SW-368 Product and engineering rules page current
SW-367 Logo hover: fold shut, then open current
SW-366 “What changed in 0.12.0” page current
SW-365 Lessons-learned page current
SW-364 Motion guide and theming guide current
SW-363 Design site shows the real palette, generated from tokens current
SW-362 The logo opens on hover and focus, everywhere current (refined by SW-367)
SW-323 Motion pass across the app current
SW-322 One loader everywhere: the opening box current
SW-317 Aurora ID card uses brand colours; loader built from the storyboard current
SW-316 Dark theme is one solid black family current
SW-313 Cold-start splash: the box opens and flies to the navbar current
SW-306 Patch on landing pages (rules) current
SW-300 Landing scroll story, symbol background, restrained motion current (dark values superseded by SW-316)
SW-299 Only the free Gilroy weights ship current
SW-277 The landing page is original, in the app’s own design language current
SW-275 Spaces home and directory with brand character; richer dark palette partly superseded by SW-316
SW-273 Settings grouped by task (senior UX pass outcome) current
SW-255 A senior UX and product review before release current
SW-247 Tagline “Run the space, not spreadsheets.”; “Lending” becomes “Inventory” current
SW-245 Professional README banner in the main repo current
SW-235 Ease-of-use pass; design repo synced to the black palette current
SW-225 Dark mode becomes true black partly superseded by SW-316
SW-222 Free Gilroy weights: licence risk accepted current (restated by SW-299)
SW-220 Designer font is a real Outfit family current
SW-219 Release 0.12.0 owner choices: fonts current (dark clause superseded by SW-225)
SW-210 Public makerspace header shows the space’s own logo current
SW-204 Light mode is the default current
SW-168 README in the Events style, with Patch peeking from a corner current
SW-152 README banner: Patch only if it still looks professional superseded by SW-168
SW-151 README banner: no mascot superseded by SW-152
SW-128 Card font library (cards only) current
SW-106 README poster banner and screenshots partly superseded
SW-57 Patch on the 404 page only; delight effects partly superseded by SW-306 and SW-362
SW-56 Patch for dark surfaces: Warm Cream sticker border current
SW-55 Patch keeps a Warm Cream card in dark mode superseded by SW-56
SW-54 Patch is sourced only from this repo; left-facing walk approved current
SW-51 Delight effects on by default; dark transition always on current
SW-32 Original Space Works artwork only current
SW-31 Everything is built only in the Space Works theme current (Gilroy 400 to 700 clause superseded by SW-299)
SW-22 Event accent: brand-palette presets only current
SW-12 Adopt Yuyu’s fun elements, redone in our brand current
DS-2 AGPL-3.0-or-later licence current
DS-3 Starlight design site on GitHub Pages current
DS-4 Mobile UX spec and mobile motion stay in the app repos current
DS-5 Space Works UX is our own spec, inspired by Yuyu current
DS-6 Patch, the painted wolf mascot current
DS-7 Brand kit v1 and Figma exports are the source of truth current
DS-8 Dark token retune, then “teal-lit” dark superseded by SW-225 then SW-316
DS-9 Links and Pages move to the SpaceWorks-Labs organisation current

Count: 67 entries, 58 from the ledger (SW-) and 9 design-only (DS-). Ledger decisions 219, 220, 222 and the other fonts and dark-mode steps are listed separately because each one changed the rules at a different date.

On this topic

Section titled “On this topic”