Contracts
Every addable object uses the shared registry envelope and returns RuleResult diagnostics.
A design system AI agents can actually use
A cleaner static-app v2 proof with real Tailwind output, reusable primitives, mock product data, design presets, and a style guide that shows full page variants.
Static-app v2Open style guide
What is wired now
The platform exposes one repeatable operation: register the building block, implement it with primitives, render realistic data, and run the gate.
Design switching
Themes and color schemes are registered and previewable from the style guide.
Bundled runtime
Tailwind v4 compiles the CSS and the style-guide runtime is bundled with esbuild.
Pipeline
The agent path is short and repeatable
Agents should not invent a separate design method. They follow the same sequence for every primitive, block, effect, or template.
1
Read catalog
Use the registry and agent guide to see what already exists.
2
Reuse first
Compose registered primitives and blocks before adding anything new.
3
Register the leaf
New blocks, effects, themes, and schemes all use the same manifest envelope.
4
Run the gate
Validation and page evals return deterministic failures with fix hints.
Mock data
Mock data makes the design feel like a product
This section reads from app/config/api-contract.json, the same easy mock-data pattern v1 uses for sourced blocks.
Northstar Clinics
Healthcare
Lumen Retail
Commerce
Bakker & Co
Services
Contracts
Contracts that make design work machine-readable
These contracts are enough to prove the architecture without pretending visual taste can be fully automated.
TokenContract
Defines the root vocabulary for CSS and Tailwind v4 aliases.
The gate fails when required token dependencies are missing.
PrimitiveContract
Owns reusable UI recipes and helper APIs.
Blocks fail when they copy managed primitive classes directly.
EffectContract
Owns tokenized motion and reduced-motion behavior.
The style guide activates registered effects through bundled JS.
VisualContract
Owns fixtures, matrices, screenshots, and human review paths.
The style guide renders primitives, states, schemes, and themes.
Proof
Proof points
This page is intentionally contract-heavy: it should expose what is implemented and what still needs human design judgment.
10+
core contract records
3
design-pack page previews
1
esbuild-bundled runtime proof