An open source design system that's fully customizable and agent ready
TypeScript
schema_version: 1 template_version: 2 kind: design id: design: authority: draft archive_reason: null superseded_by: null approved_by: null approved_at: null owners: [] review_triggers: [visual, interaction] verified_by: [] architecture: [architecture:] components: [component:] families: [family:] deciding_specs: [spec:AST-000/DEC-0]
design specification
User intent
Design principles
- DR1 —
<principle>.<The experience MUST …>
Anatomy and hierarchy
| Role | Purpose | Required relationship |
|---|---|---|
<role> |
<purpose> |
<relationship> |
State representation
| State | Required representation | Allowed variation |
|---|---|---|
<state> |
<what must remain perceivable> |
<what themes/components may vary> |
Responsive and input behavior
- DR2 —
<contract>.<At this constraint/input mode, the experience MUST …>
Accessibility intent
Representative examples
Visual references
| Asset | State | Theme or mode | Viewport | What it demonstrates | Alt text |
|---|---|---|---|---|---|
./assets/<design-id>/<file>.png |
<state> |
<mode> |
<size or n/a> |
<decision> |
<description> |
Component contract links
component:<Name>/FR1implementsdesign:<surface>/DR1.
Decision log
DEC-1 — <human design decision>
Reference: design:<surface>/DEC-1
Decider: <person>, <YYYY-MM-DD>
<Reason and user impact.>
Open questions
- OQ1 —
<human design question>
Content boundary
This file does not define prop syntax, implementation structure, current audit scores, or consumer examples. It links to those owners.