# DESIGN.md — règles d'interface

Lis ce fichier avant de créer ou de modifier une interface. Applique-le strictement.
Principe : calme, dense, précis. Peu de couleur, une hiérarchie par la taille et le gris.

## 1. Couleurs

- Couleur d'accent : [TA_COULEUR]. Réservée aux boutons principaux, au lien actif et au focus.
- Aucune couleur neutre en dur. Utilise ces rôles, définis en clair ET en sombre :
  - bg (fond de page), surface (cartes, modales, menu), surface-2 (survol, champs, squelettes)
  - fg (texte principal), fg-muted (texte secondaire), fg-subtle (méta, placeholders)
  - border = fg à 8 % d'opacité, border-strong = fg à 15 %
- Statuts : fond teinté à 10 %, bordure à 25 %, texte plein. Jamais d'aplat saturé.
- Pas de dégradé décoratif. Mot mis en avant dans un titre = fg-muted.

## 2. Typographie

- Une seule famille : [TA_POLICE, ex. Geist ou Inter], graisses 400/500/600/700.
- Tailles en px exacts :
  - Titre de page : 44 px (52 px sur grand écran), 600, letter-spacing -0.03em, line-height 1.05
  - Chiffre clé : 36 px, 600
  - Titre de carte / modale : 17-20 px, 600
  - Corps : 14-15 px. Champs de saisie : 15 px
  - Listes, tableaux, menus : 12.5-13 px
  - Méta, dates : 11.5-12 px, fg-subtle
  - Label de section : 11 px, majuscules, letter-spacing 0.16em, 600, fg-subtle
- Tous les nombres en chiffres tabulaires (font-variant-numeric: tabular-nums).
- Sous-titre de page : une seule ligne. Titres en sentence case.

## 3. Icônes

- Lucide uniquement. Aucun emoji dans l'interface.
- Plus l'icône est petite, plus le trait est épais :
  22 px → 1.5 · 18 px → 1.75 · 16 px → 1.75 · 14 px → 2 · 12 px → 2.5 · 11 px → 3
- Bouton icône seul : aria-label obligatoire.

## 4. Formes et espacements

- Espacements multiples de 4 px.
- Rayons : 8 px (petits boutons, items de menu) · 12 px (champs) · 16 px (menus, sidebar) · 18 px (cartes, modales) · full (boutons, badges, avatars).
- Boutons en pilule : padding 12px 22px, 14 px, 500. Un seul bouton plein par écran.
- Page : padding horizontal 40 px. Cartes : padding 24-28 px, grilles gap 16 px.
- Carte de contenu : bordure, aucune ombre, immobile au survol (la bordure passe en border-strong).
- Carte cliquable : translateY(-2px) + ombre 0 12px 30px -16px au survol.
- Ombres seulement sur ce qui flotte (menus, modales, sidebar), avec spread négatif.
- Jamais de carte dans une carte. Séparer par l'espace avant d'ajouter un filet.

## 5. Mouvement

- Entrées et survols : cubic-bezier(0.22, 1, 0.36, 1). Menus et panneaux : cubic-bezier(0.32, 0.72, 0, 1).
- Durées : couleur 150 ms · menu 160-180 ms · lift de carte 220 ms · entrée de page 240 ms. Jamais plus de 250 ms pour une entrée.
- Déplacements de 4 à 6 px, scale ≤ 2 %.
- Retour au clic immédiat : active:scale-[0.985], barre de chargement.
- Chargement = squelette (bloc surface-2 + reflet qui balaie), pas de spinner plein écran.
- Pas d'animation décorative en boucle dans l'app.
- Chaque animation a son bloc @media (prefers-reduced-motion: reduce).

## 6. Shell

- Sidebar flottante : à 10 px des bords, rounded-2xl, bordure + ombre douce. 264 px déplié, 72 px replié.
- Les icônes restent fixes pendant le repli, seuls les libellés disparaissent.
- Lien actif : fond accent à 10 %, barre de 3 × 20 px à gauche, texte 600.
- État replié et thème posés avant le premier rendu (script dans le head) : rien ne saute.

## 7. Contenu : ce qu'on affiche

Pour chaque élément, demande-toi : quelle action ça aide ici ? L'utilisateur le sait-il déjà ?
C'est utile tout le temps ou parfois ? Sa taille correspond-elle à son importance ?
Ne supprime jamais une fonctionnalité : retire de l'affichage, réduis, replie (survol, infobulle, section repliée).

Budgets par écran :
- Titre : 1, 3 mots max. Sous-titre : 0 ou 1 ligne, 60 caractères max.
- Cartes de chiffres en haut : 4 max.
- Indicateurs par ligne de liste : 2 max.
- Texte d'aide permanent : 0 (sauf action irréversible).
- Encart d'astuce permanent : 0.
- Le plus gros élément de l'écran est le plus important.

## 8. Composants

- Utilise les composants shadcn/ui existants avant d'en créer un nouveau.
- Champ : surface, bordure, rayon 12 px, 15 px. Focus = bordure accent à 55 %, pas d'anneau.
- Modale : overlay noir 50 % + backdrop-blur, carte max-w-2xl, en-tête fixe, corps qui défile, pied d'actions.
- Badge de statut : pilule 11 px, point de 6 px, fond 10 % / bordure 25 %.
- État vide : une icône dans une tuile 56 px, un titre, une phrase, l'action qui remplit.
- Menu déroulant : rounded-2xl, items 13 px, ferme au clic extérieur et sur Échap.

## 9. Checklist avant de livrer

1. Une police, tailles de l'échelle, nombres tabulaires.
2. Lucide, aucun emoji.
3. Aucune couleur neutre en dur, testé en clair et en sombre.
4. Accent seulement sur l'action principale et les repères.
5. Boutons pilule, rayons cohérents.
6. Cartes plates, ombre seulement sur ce qui flotte.
7. Squelette de chargement, retour au clic visible.
8. Animations ≤ 250 ms, reduced-motion géré.
9. Sous-titre d'une ligne max, aucun texte d'aide inutile.
10. Testé à 375 px de large, pas de défilement horizontal.
