# Design System: [name]

> The contract between design and code – tokens, components, and the
> rules for composing them. If it isn't documented here, it doesn't
> exist.

| Field | Value |
|-------|-------|
| System | [name] |
| Version | N.N |
| Owner | @name |
| Status | Draft / Adopted |

## Principles

1. [e.g. consistency over novelty]
2. [e.g. accessible by default]
3. [e.g. compose, don't fork]

## Foundations

### Color tokens

| Token | Value | Use |
|-------|-------|-----|
| `--color-primary` | #NNNNNN | Key actions |
| `--color-surface` | #NNNNNN | Backgrounds |

### Type scale

| Token | Size / weight | Use |
|-------|---------------|-----|
| `text-display` | NN/semibold | Hero |
| `text-body` | NN/regular | Paragraphs |

### Spacing & radius

| Token | Value | Use |
|-------|-------|-----|
| `space-1` | Npx | |
| `radius-md` | Npx | Cards |

## Components

| Component | Status | Spec | Notes |
|-----------|--------|------|-------|
| Button | Stable | [link] | Variants: solid/soft/ghost |
| Input | Beta | [link] | |
| [component] | Proposed | | |

### Component anatomy (repeat per component)

- Variants: [list]
- States: default / hover / active / disabled / loading
- Do: [usage rule]
- Don't: [anti-pattern]

## Accessibility contract

- Contrast: AA minimum (4.5:1 text, 3:1 UI)
- Focus: visible ring on every interactive element
- Keyboard: full operability, no traps
- Motion: respects reduced-motion preference

## Contribution

| Step | Process |
|------|---------|
| Propose | [issue / rfc] |
| Review | [who approves] |
| Release | [versioning rule – breaking = major] |

## Changelog

| Version | Date | Changes |
|---------|------|---------|
| 1.0 | YYYY-MM-DD | Initial |