design-system

Installation
SKILL.md

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 :

  1. des tokens en source unique (bloc @theme de Tailwind v4) ;
  2. 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 ;
  3. des composants shadcn/ui sur Radix ou Base UI (style base-* de components.json), dont les variantes CVA posent ces classes : <Button variant="primary" size="sm"> rend btn 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.

Installs
50
Repository
fpasquet/skills
First Seen
Nov 7, 2026