# Repository Instructions

## UI changes

Before changing UI, themes, layout, spacing, colors, or components:

1. Read `docs/ui-design.md`.
2. Reuse its global design tokens; do not introduce page-specific radii, spacing, or semantic colors.
3. Update or add a failing test before changing behavior or visual rules.
4. Run:

   ```bash
   pnpm test -- --run tests/unit/design/consistency.test.ts
   pnpm test -- --run tests/unit/design/contrast.test.ts
   pnpm check
   ```

Switches, circular progress, avatars, and other function-defined shapes are exempt from the shared radius rule.