Design-repository decisions (DS)

DS-9 — Links and Pages move to the SpaceWorks-Labs organisation

Date: 26 October
Decision: Documentation links and the Pages site point at the SpaceWorks-Labs GitHub organisation.
Why: The organisation was renamed (from an earlier HQ name); links to the old name would break or mislead.
Status: current.
Implemented in: README.md, site/astro.config.mjs. Commit de06880.

Date: 19 to 20 October
Decision: The mascot is Patch, an African painted wolf with a wrench, inside a Maker Teal badge. It is cut from the approved concept sheets and traced to vector without redrawing; the exact original pixels are kept (lossless) alongside lighter compressed copies. Patch is the friendly face for empty states, onboarding and merch; the box symbol stays the logo.
Why: Painted wolves match the product’s values: no two coats alike (a community of different makers), they vote by sneezing (the community decides together), they look after the whole pack (a commons, nobody left behind), they succeed as a team, and they are endangered. The name “Patch” nods to the patchwork coat, to repair and maker culture, and to a software patch. Other animals were already taken by other brands.
Status: current.
Implemented in: mascot/ (see mascot/README.md). Commits 114a64b, fc22f06, 8cad666.

Date: 15 and 19 October
Decision: The UX pattern specs are named Space Works UX and written in our own words and screens, with Yuyu credited as the inspiration and its reference boards kept under references/yuyu/. Screenshots of Space Works UX in the Events app, light, dark and phone, feed the site’s UX pages.
Why: Reason not recorded beyond the commit message: “Make the UX spec our own”. The intent is to learn from a good reference without copying it (see SW-31). Note that later decisions SW-129 to SW-131 and SW-130 settle how code from the same reference may be reused in the app; they do not change this spec.
Status: current.
Implemented in: docs/ux-spec.md, docs/ux-screens-longtail.md, screenshots/ux/, references/yuyu/. Commits d4907b0, 3661b75, 85064b5, c9bf941.

Date: 16 October
Decision: The mobile-only UX specification and mobile motion additions are removed from this repo and kept in the app repositories. Brand assets and tokens are unchanged.
Why: At the owner’s request; reason beyond that not recorded. Mobile apps are built separately (the Android and iOS repos) and own their own behaviour.
Status: current.
Implemented in: Commit 6bcbd0a (removal); commit 3c61599 added them first.

Date: 16 October
Decision: The design system is browsable as a Starlight website published to GitHub Pages from site/ on every push to main. The site copies the kit in at build time.
Why: Reason not recorded beyond the commit. In practice it makes the logo masters, colours, type, voice, tokens and specs viewable without cloning, and later (SW-363) keeps the displayed palette in step with the tokens.
Status: current.
Implemented in: site/, .github/workflows/deploy-site.yml, site/scripts/sync-kit.mjs. Commit fd28f82.

Date: 16 October
Decision: The design system is licensed under AGPL-3.0-or-later.
Why: Reason not recorded in the commit or the ledger. It matches the main product’s licence.
Status: current.
Implemented in: LICENSE. Commit a13c512.

Date: 15 October
Decision: The approved brand kit (guidelines v1 PDF, ten logo masters exported from Figma, icons, fonts, tokens and UX specs) is published here, and projects use the repo as a git submodule so every surface draws from one source.
Why: One place for the brand, so apps do not keep private copies that drift. Seven brand colours, “neutral first, accent second”, and “never orange text on cream” come from the same kit.
Status: current (v1 kept when v2 was added, see SW-373).
Implemented in: brand/, logo/, icons/, tokens/, README.md. Commits a15a280, 0ff2c38, 8225ce1.