/design-system
Si vous voyez des espaces réservés inconnus 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
Tokens de Design
Valeurs atomiques qui définissent le langage visuel :
- Couleurs (marque, sémantiques, neutres)
- Typographie (échelle, graisses, interlignes)
- Espacement (échelle, espacement 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 des éléments définis :
- 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 courantes 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 de nommage
| Problème | Composants | Recommandation |
|----------|------------|----------------|
| [Nommage incohérent] | [Liste] | [Standard à adopter] |
### Couverture des tokens
| Catégorie | Définis | 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 | Docs | Score |
|-----------|-------|-----------|------|-------|
| Bouton | ✅ | ✅ | ⚠️ | 8/10 |
| Champ | ✅ | ⚠️ | ❌ | 5/10 |
### Actions prioritaires
1. [Amélioration la plus impactante]
2. [Deuxième priorité]
3. [Troisième priorité]
Sortie — Document
## Composant : [Nom]
### Description
[Ce qu'est ce composant et quand l'utiliser]
### Variantes
| Variante | Utiliser quand |
|----------|---------------|
| [Primaire] | [Actions principales] |
| [Secondaire] | [Actions secondaires] |
### 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 — Extension
## Nouveau composant : [Nom]
### Problème
[Quel besoin utilisateur ou lacune ce composant adresse]
### Motifs existants
| Composant associé | Similitude | Pourquoi ce n'est pas suffisant |
|-------------------|------------|---------------------------------|
| [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 | Utiliser quand | Visuel |
|----------|---------------|--------|
| [Variante] | [Scénario] | [Description] |
#### États
| État | Comportement | Notes |
|------|-------------|-------|
| Défaut | [Description] | — |
| Survol | [Description] | [Interaction] |
| Désactivé | [Description] | Non interactif |
| Chargement | [Description] | [Animation] |
#### Tokens utilisés
- Couleurs : [Quels tokens]
- Espacement : [Quels tokens]
- Typographie : [Quels tokens]
### Accessibilité
- **Rôle** : [rôle ARIA]
- **Clavier** : [interactions attendues]
- **Lecteur d'écran** : [annoncé comme…]
### Questions ouvertes
- [Décision qui nécessite une revue de design]
- [Cas limite à résoudre]
Si des connecteurs sont disponibles
Si ~~outil de design est connecté :
- Auditez les composants directement dans Figma — vérifiez le nommage, les variantes et l'utilisation des tokens
- Récupérez les propriétés des composants et la structure des calques pour la documentation
Si ~~base de connaissances est connectée :
- Recherchez la documentation et les directives d'utilisation existantes des composants
- Publiez la documentation mise à jour sur 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.
- Donnez la priorité à la couverture plutôt qu'à la perfection — 80 % des composants documentés vaut mieux que 100 % de 10 composants.