# `shared/design-system/`

## Purpose

Design system documentation, tokens, composition patterns, and barrel exports — the **semantic layer** above `shared/ui/` primitives.

## Legacy source (not moved)

- `components/ds/index.ts` — primary barrel
- Module-specific tokens:
  - `components/beauty/design-system/tokens.ts`
  - `components/healthcare/ui/tokens.ts`

## Planned contents

- Platform tokens (spacing, radius, shadows) — aligned with `styles/globals.css`
- `tone` / `variant` conventions
- Composition guidelines (PageHeader + DataTable + Dialog patterns)
- Module accent token interface (`--{module}-accent`)

## Relationship to `shared/ui/`

| Layer | Responsibility |
|-------|----------------|
| `design-system/` | Tokens, patterns, docs, exports |
| `ui/` | Implementation components |

## Status

📁 Scaffold only — DS remains in `components/ds/`.
