- Add or update the component in
packages/components/src/components/ui/. - Use
cn()and export*Variantsfor variant-driven components. - Export from
packages/components/src/index.ts. - Add a docs example in
apps/docs/src/pages/. - Run
pnpm changesetfor user-facing changes.
- Compound APIs for multi-part components (e.g.
Card.Header,Dialog.Content). - Brand tokens via CSS variables — no hardcoded hex in components.
- Icons:
lucide-reactviaIconwrapper or direct import. - Tests: add Vitest smoke tests in
packages/components/src/.