Design system
Stub. This section is reserved. Content lands in a follow-up PR once the design-system spec is authored.
What will live here
The design system documents the product UI primitives: tokens, components, and usage rules. It's distinct from the brand identity (which lives in ../brand/).
Planned shape:
| Doc | Covers |
|---|---|
00-overview.md | What the design system is, who it's for, how to consume it |
01-tokens.md | Color, typography, spacing, radius tokens. Source of truth for --color-*, --text-*, --space-* |
02-components.md | Component anatomy and usage rules — chips, hero blocks, metric tiles, action cards |
03-patterns.md | Composition patterns (e.g. page hero rhythm, brief layout, chain diagram conventions) |
04-do-not.md | Forbidden constructs (cards with borders, scores, modals, charts) |
Current source of truth (interim)
While this section is unwritten, the de-facto source of truth lives in:
sv0-platform/ui/src/index.css— the only Tailwind v4 token file. CSS-based, notailwind.config.ts.sv0-platform/UX-GUIDE.md— terminology, page architecture, typography hierarchy, copy rules.
When the design-system docs land here, those files become consumers of this canonical spec.