Principles
- runtime
- constitution + covenant + refusal posture
- downstream
- no custody, no advice, replayable, geofenced claims
universe map· 33 canonical chapters + 7 agentic-stack chapters · 15 dimensions · 1 organism
every chapter has its own surface
this is the canonical map. 33 chapters of the zero brand universe, each wired to a deep surface, each machine-checked, each independently calibrated and mutually calibrated to the others. the agentic stack (7 runtime packages) sits below as an appendix · each with its own deep surface. the universe is the app. getzero.dev is the floor on which it shows itself.
as of
stack walk · live
the seven agentic chapters · each backed by exactly one runtime authority and one cockpit surface. click any node · the trace renders the module · the symbols · the surface · the ADR that introduced it · and the cmd-K verb the operator invokes to land on the live demo.
trade receipt
- picked
- agent stream
- authority
- @zero/agent-stream
- symbols
- 4
- surfaces
- /agent-stream
- adr
- ADR-026
- note
- each node is one runtime authority · zero parallel implementations
as of
01 · chapterstwenty-six · canonicaleach chapter wires a runtime hook to a downstream artifact
chapters are not topics — they are wired contracts. every row below has a runtime hook (the code that ships) and a downstream artifact (where it surfaces). every row links to its deep surface.
Identity
livemark, lockup, sigil, mascot, naming boundary
Voice and tone
livelowercase, terse, precise, replayable + OFF-WHITE 3% quotation rule on marketing surfaces only
Lexicon
livecanonical product verbs and nouns
Color
liveink, bone, acid (brand signature · wordmark · focus · drops), amber (inheritance signal · capital-markets · journal · cockpit), data + warning + status roles, pulse modulation, OKLCH-derived
Typography
display/data duties and mono contract
Layout system
rail, chrome, density, panes, grids
Motion
livefour-clock organism, gestures, reduced motion + ceremony cadence (signing, settlement, refusal, demolition, trade-in, raid)
Sound
liveprogrammatic cues, opt-in, off by default
Haptics
livetactile equivalents for mobile/operator surfaces
Illustration
liveprocedural/pixel operators, no generic AI imagery
Ornament
liveallowable atmosphere without decorative drift
Tokens
livemachine-readable source for every surface · 17 categories
Components
liveprimitive contracts and dossiers · 86 ceiling (ADR-020) · 62 brand + 20 agentic + 4 reserved
Forms
the form-input pack · 14 primitives sharing the seven-state form grammar (idle · hover · focus · invalid · disabled · readonly · refuse) · the only legitimate way operators enter text, choose dates, pick files, or commit refusal reasons
Writing
livebefore/after copy, disclaimers, banned claims
Negative covenant
liverelease-blocking design/language rules · 17 nots
Drops and ritual
liveThursday 11:00 ET cadence, raid window, gifted-50, trade-in, reverse-scarcity, settlement ceremony
Tier ladder
tier-aware public + operator product surfaces and actions
Applied standards
the standards manual that aggregates the consumed contracts (tokens, primitives, voice, drops, tiers)
Accessibility
liveeighteen probes · nine static (ci:a11y on every prerendered chapter · ADR-021) · five dynamic (window.zero.a11y) · four self-attested · WCAG AAA on body roles · reduced motion gates motion+sound+haptics together
Skins
liveOKLCH-derived color authority · six canonical skin contracts (signature, bloomberg, midnight, ceremony, refuse, specimen) · acid-as-signature + amber-as-inheritance · generative per-agent · provable AAA contrast
Ambient
liveambient brand engine · four-tier renderer (CSS / Canvas worker / WebGL / WebGPU) · capability governor + motion governor + semantic bus · glass-layer composition · pointer ripple · accessibility guarantees (reduced-motion · low-power · save-data)
Microcopy
livecontent discipline · three laws (clarity, concision, character) · banned-phrase ledger · jargon translator · sentence-length budget (avg 12 / max 22) · component-level copy rules (button labels, form fields, validation, empty states)
Universe
the cover · what this design system is and how to consume it
Changelog
demolition log of every shipped floor and the 90d cycle phases
Icons
the icon system · 40-glyph baseline in 5 categories of 8 (navigation · status · action · finance · agentic) · 24×24 viewBox · 1.5px stroke · currentColor only · the only legitimate way to render a glyph in the zero universe
Data
the data-display pack · 6 primitives sharing one tabular grammar (DataTable · Pagination · Tree · Calendar · EmptyState · Skeleton) · the seven-state cell grammar from forms carries through · the only legitimate way to render rows, pages, hierarchies, calendars, empty states, or loading states
Performance
four perf gates restored · bundle (per-route first-load JS) · ssr (per-route HTML + chunk count) · web-vitals (contract ↔ runtime parity, no browser) · attestation (sha256 of every primary build output + CycloneDX SBOM) · single budgets contract · tightening = ADR, loosening = ADR + brand-veto
Charts
the charts expansion · 18 SSR primitives in @zero/charts (12 display: Bar/Area/Donut/Treemap/Gauge/Waterfall/BoxPlot/DotMatrix/OrderBook/Footprint/VolumeProfile/MultiAxis on top of the original Sparkline/Line/Candle/Heatmap/DepthBar/Histogram, plus 4 composition: AxisX/AxisY/Legend/LayeredSurface) · the LayeredSurface primitive composes five layers (liquidity · price · delta · annotation · microstructure) · LayerKind / Annotation / ScaleTier types are the v2 webgpu adapter contract · ceiling 24 primitives · every chart has a dossier (num · cls · states · tokens · description · kind)
Agent context
the agent context layer (ADR-024) · three-file stack for 2026-grade coding agents (Claude Code, Codex, Cursor, Copilot, Windsurf): AGENTS.md (always-on protocol · 32 KiB cap, OpenAI/LF standard) + DESIGN.md (always-on visual identity · 24 KiB cap · YAML frontmatter + Markdown prose · Google Labs Apache 2.0) + brand/designtoken.md (agent-readable token superset · agentskills.io DTCG-superset) · underneath: dist/dtcg.json (W3C Design Tokens Community Group v1.0 · first stable revision 2025-10-28 · every leaf has $type/$value · color leaves carry $extensions.zero.oklch metadata per ADR-013) · closes audit gap #7 (single-file agent context)
Overlays
the overlay completion pack (ADR-025) · ten-overlay vocabulary across @zero/ui: five existing Floating-UI overlays (Tooltip · Popover · Dropdown · Dialog · ToastProvider) plus five new (Sheet · Drawer · Accordion · ContextMenu · AlertDialog) · every overlay declares one of three anchors (viewport · edge · anchor) and one of three dismissals (casual · committed · manual) via the shared overlay-anchor.ts contract · AlertDialog tone='refuse' is the brand-verb overlay (committed dismissal · amber hairline · confirm label defaults to 'refuse') · closes audit gap #8 · raises catalog ceiling 86 → 91 (67 brand + 20 agentic + 4 reserved)
Theme system
the theme-system pack (ADR-026) · four React-tree-level providers (ThemeProvider · MotionProvider · DensityProvider · LocaleProvider) that pin the four cross-cutting brand contracts (substrate, motion, density, locale) at the React Context layer · ThemeProvider hard-codes substrate='dark' per article I (no light-mode prop · no escape) · MotionProvider pivots --ease-step + --breath + --pulse via [data-motion] · DensityProvider generalizes ADR-020's local DataTable triplet to every primitive via [data-density] · LocaleProvider sets lang/dir on its wrapper and exposes useLocale() to every formatter · raises catalog ceiling 91 → 95 (71 brand + 20 agentic + 4 reserved) · closes the audit's 8-ADR roadmap
Receipt vocabulary
the eight-receipt vocabulary (ADR-027) · every event in the constitution's ledger lands as a typed, signed, deterministic 50-column box-drawing artifact · trade + refuse (existing, article II.3) plus six new helpers (sign, settlement, demolition, revoke, rotate, migrate) · the @zero/ui Receipt primitive's `kind` union widens 2 → 8 to render any of them · @zero/ui primitive ceiling unchanged (Receipt is already primitive #18) · brand-runtime tests now run inside the monorepo vitest pipeline
as of
02 · dimensionsfifteen · co-calibrateddimensions are the runtime axes
chapters describe content; dimensions describe the runtime structure that makes the brand a system instead of a style guide. every dimension is wired to multiple chapters; every chapter inherits multiple dimensions.
Modality
- runtime
- terminal / paper / signal / cockpit / receipt / replay / command / sound / haptics / reduced motion
- downstream
- mode-aware public and operator shells
Layout
- runtime
- rail + topbar + status + chapter grid + cockpit grid + proof surfaces
- downstream
- route shells, mobile collapse, density tiers
Shell
- runtime
- ShellLayout + brand runtime + mascot + pulse + chrome
- downstream
- consumer-app shared chrome and public floor
Tokens
- runtime
- color, type, spacing, radius, hairlines, motion, opacity, z, breakpoints, density, pulse
- downstream
- generated adapter tokens
Components
- runtime
- @zero/ui primitives, dossiers, receipts, gates, stat cells, charts
- downstream
- route-level composition
Choreography
- runtime
- clock model, gesture grammar, scene pause, scroll state, pulse, refuse moments
- downstream
- one organism across page transitions
Voice and Copy
- runtime
- rewrite tester, banned words, lexicon, worked examples
- downstream
- lowercase, terse, precise, public-safe copy
Product Truth
- runtime
- Hyperliquid loop, risk gates, immune, MCP, replay/finality, paper-first
- downstream
- homepage and route content
Governance
- runtime
- release cadence, checks, source boundaries, jurisdiction policy
- downstream
- brand checks and route contracts
Distribution
- runtime
- package/artifact boundary, extraction, checksums
- downstream
- consumer adapter and contract validation
Label
- runtime
- Kaikai Kiki record-label model · agents are signed artists, not features
- downstream
- /a/<shortId>, /league, AgentArtistCard, label vocabulary lock
Skins
- runtime
- OKLCH color authority · six canonical skin contracts · generative per-agent · brand-signal/data-signal/warn/success/error/info/ground/figure roles
- downstream
- data-skin attribute · per-surface skin override · SkinPicker · PaletteRing · TimeOfDayMark
Field runtime
- runtime
- ambient brand engine · capability governor (A/B/C/D) · motion governor · semantic bus · 4 tier renderers (CSS / Canvas worker / WebGL / WebGPU) · liquid glass · pointer ripple
- downstream
- AmbientEngine provider mounted at root · GlassLayer composition · CapabilityProbe surface · data-ambient-tier on html · semantic state on html drives ambient hue + speed
Microcopy discipline
- runtime
- three laws (clarity, concision, character) · banned-phrase ledger · jargon translator · sentence-length budget · component-level copy rules (button, form, validation)
- downstream
- RewriteTester live grader · /microcopy deep surface · check-microcopy.mjs CI gate · enforced across button/form/error/empty-state copy
as of
03 · agentic stackseven packages · seven surfaces · ADR-037the brand speaks every protocol coding agents speak
seven runtime packages — MCP server, AG-UI consumer, five-stratum memory, local-only intent inference, A2UI streaming UI, GPU specular liquid glass, and the explicit token graph. each ships its own deep surface that demonstrates the protocol against the brand's primitive vocabulary.
mcp · model context protocol
liveJSON-RPC 2.0 over stdio · 6 resources · 3 tools · zero deps
agent-stream · ag-ui consumer
live17-event AG-UI reducer · renders through 12 agentic primitives
memory · five-stratum contract
livefive strata · localStorage + in-memory backends · local-first
intent · local-only earl
live8 observation kinds · pure ranker · 0 telemetry
a2ui · streaming generative ui
liveflat adjacency list · 16 kinds · closed registry
liquid glass · gpu specular
live~30 frag instructions · idle-zero · CSS fallback
token graph · dependencies
live212 nodes · 19 categories · zero://tokens/graph (mcp)
as of
04 · coveragepublic commitmentwhat is live · what is embedded · what is planned
live means a dedicated route exists. embedded means the chapter is documented inside another live route. planned means the surface is on the roadmap and currently 404. nothing is hidden.
18 · live0 · embedded0 · planned+ 7 · agentic stack