design-system
Design system React : tokens, classes sémantiques, shadcn/ui, Storybook
Ce skill met en place et fait vivre le design system d'une application React (Next.js ou Vite) en trois couches :
- des tokens en source unique (bloc
@themede Tailwind v4) ; - un thème shadcn/ui pointé sur ces tokens, et des classes sémantiques (
btn,btn-primary,card) dans@layer components, le CSS de chaque composant à côté de lui ; - des composants shadcn/ui sur Radix ou Base UI (style
base-*decomponents.json), dont les variantes CVA posent ces classes :<Button variant="primary" size="sm">rendbtn btn-primary btn-sm.
Avec daisyUI, les classes sémantiques sont les siennes, réglées par un thème daisyUI pointé sur les mêmes tokens, et les composants React posent ses classes (btn, btn-primary, card). Le reste ne change pas. Le mode est repéré seul (@plugin "daisyui"), ou choisi par scaffold.mjs --classes daisyui : lire references/daisyui.md avant le premier changement.
Storybook documente le tout : pages Tokens et Classes, une histoire par état, et un contrôle d'accessibilité qui bloque. Le lint garde les classes propres.
Trois modes, choisis à l'étape 0 :
- créer à partir de l'existant ;
- maintenir : ajouter un composant, un token ou une classe, mettre à jour une version ;
- migrer un design system existant vers ces conventions.
Échanges, documentation et commentaires en français. Code, identifiants, noms de classes et d'histoires en anglais.