Design philosophy & three-tier theming

Generated from pattern-library/registry.json — do not edit by hand; change the registry and run bun run patterns:build.

Index card — the docs below are the canonical explanation; deep-tier pattern pages additionally carry invariants and emulation notes.

Category: UI Components & Design System · Tier: light · Maturity: proven (verified 2026-08-20 @ 1a130d67) · Risk: low — documentation/convention only

Five content-first, accessibility-driven design principles paired with a three-tier token system (primitives → semantic tokens → component usage) flowing from src/app.css through tokens.ts into UnoCSS.

When to use: Read before making a visual design decision or introducing a new design token, to keep it aligned with the system's principles and token layering.

Docs

• docs/blueprint/design/README.md (GitHub · GitLab)

Code

• src/app.css (GitHub · GitLab)
• src/lib/styles/tokens.ts (GitHub · GitLab)

Proof

• /showcases/ui/tokens
• /showcases/shell/style

Machine-readable record: ui-design-philosophy in pattern-library/registry.json.