/design-system
Si vous voyez des espaces réservés inhabituels ou devez vérifier quels outils sont connectés, consultez CONNECTORS.md.
Gérez votre système de design — auditez la cohérence, documentez les composants ou concevez de nouveaux motifs.
Utilisation
/design-system audit # Audit complet du système
/design-system document [composant] # Documenter un composant
/design-system extend [motif] # Concevoir un nouveau composant ou motif
Composants d'un système de design
Jetons de design
Valeurs atomiques qui définissent le langage visuel :
- Couleurs (marque, sémantique, neutre)
- Typographie (échelle, graisses, hauteurs de ligne)
- Espacement (échelle, remplissage des composants)
- Bordures (rayon, épaisseur)
- Ombres (niveaux d'élévation)
- Mouvement (durées, courbes d'accélération)
Composants
Éléments d'interface réutilisables avec :
- Variantes (primaire, secondaire, fantôme)
- États (défaut, survol, actif, désactivé, chargement, erreur)
- Tailles (sm, md, lg)
- Comportement (interactions, animations)
- Accessibilité (ARIA, clavier)
Motifs
Solutions d'interface communes combinant des composants :
- Formulaires (groupes de saisie, validation, soumission)
- Navigation (barre latérale, onglets, fil d'Ariane)
- Affichage de données (tableaux, cartes, listes)
- Retour d'information (toasts, modales, messages en ligne)
Principes
- Cohérence avant créativité — Le système existe pour que les équipes ne réinventent pas la roue.
- Flexibilité dans les contraintes — Les composants doivent être composables, pas rigides.
- Tout documenter — Si ce n'est pas documenté, ça n'existe pas.
- Versionner et migrer — Les changements cassants nécessitent des chemins de migration.
Sortie — Audit
## Audit du système de design
### Résumé
**Composants examinés :** [X] | **Problèmes trouvés :** [X] | **Score :** [X/100]
### Cohérence du nommage
| Problème | Composants | Recommandation |
|----------|------------|----------------|
| [Nommage incohérent] | [Liste] | [Standard à adopter] |
### Couverture des jetons
| Catégorie | Défini | Valeurs codées en dur trouvées |
|-----------|--------|-------------------------------|
| Couleurs | [X] | [X] occurrences de hex codé en dur |
| Espacement | [X] | [X] occurrences de valeurs arbitraires |
| Typographie | [X] | [X] occurrences de polices/tailles personnalisées |
### Complétude des composants
| Composant | États | Variantes | Doc | Score |
|-----------|-------|-----------|-----|-------|
| Bouton | ✅ | ✅ | ⚠️ | 8/10 |
| Saisie | ✅ | ⚠️ | ❌ | 5/10 |
### Actions prioritaires
1. [Amélioration la plus impactante]
2. [Deuxième priorité]
3. [Troisième priorité]
Sortie — Documenter
## Composant : [Nom]
### Description
[Ce qu'est ce composant et quand l'utiliser]
### Variantes
| Variante | Utilisation |
|----------|-------------|
| [Primaire] | [Actions principales] |
| [Secondaire] | [Actions de support] |
### Props / Propriétés
| Propriété | Type | Défaut | Description |
|-----------|------|--------|-------------|
| [prop] | [type] | [défaut] | [description] |
### États
| État | Visuel | Comportement |
|------|--------|--------------|
| Défaut | [description] | — |
| Survol | [description] | [interaction] |
| Actif | [description] | [interaction] |
| Désactivé | [description] | Non interactif |
| Chargement | [description] | [animation] |
### Accessibilité
- **Rôle** : [rôle ARIA]
- **Clavier** : [comportement Tab, Entrée, Échap]
- **Lecteur d'écran** : [Annoncé comme...]
### À faire et à ne pas faire
| ✅ À faire | ❌ À ne pas faire |
|-----------|------------------|
| [Bonne pratique] | [Anti-patron] |
### Exemple de code
[Extrait de code adapté au framework]
Sortie — Étendre
## Nouveau composant : [Nom]
### Problème
[Quel besoin utilisateur ou lacune ce composant adresse]
### Motifs existants
| Composant lié | Similitude | Pourquoi cela ne suffit pas |
|---------------|------------|-----------------------------|
| [Composant] | [Ce qui est partagé] | [Ce qui manque] |
### Conception proposée
#### API / Props
| Propriété | Type | Défaut | Description |
|-----------|------|--------|-------------|
| [prop] | [type] | [défaut] | [description] |
#### Variantes
| Variante | Utilisation | Visuel |
|----------|-------------|--------|
| [Variante] | [Scénario] | [Description] |
#### États
| État | Comportement | Notes |
|------|--------------|-------|
| Défaut | [Description] | — |
| Survol | [Description] | [Interaction] |
| Désactivé | [Description] | Non interactif |
| Chargement | [Description] | [Animation] |
#### Jetons utilisés
- Couleurs : [Quels jetons]
- Espacement : [Quels jetons]
- Typographie : [Quels jetons]
### Accessibilité
- **Rôle** : [rôle ARIA]
- **Clavier** : [Interactions attendues]
- **Lecteur d'écran** : [Annoncé comme...]
### Questions ouvertes
- [Décision nécessitant une revue de design]
- [Cas limite à résoudre]
Si des connecteurs sont disponibles
Si un ~~outil de design est connecté :
- Auditez les composants directement dans Figma — vérifiez le nommage, les variantes et l'utilisation des jetons
- Récupérez les propriétés des composants et la structure des calques pour la documentation
Si une ~~base de connaissances est connectée :
- Recherchez la documentation existante des composants et les directives d'utilisation
- Publiez la documentation mise à jour dans votre wiki
Conseils
- Commencez par un audit — Sachez où vous êtes avant de décider où aller.
- Documentez en construisant — Il est plus facile de documenter un composant pendant sa conception.
- Priorisez la couverture à la perfection — 80 % des composants documentés bat 100 % de 10 composants.