J'ai construit des dizaines d'apps et de sites avec Claude Code. Au début, elles avaient toutes la même tête : dégradé violet, emojis dans les titres, une ombre sous chaque carte et trois lignes d'explication sous chaque bouton.
Claude ne manque pas de goût. Il manque de règles. Sans consignes, il fait la moyenne de tout ce qu'il a vu, et la moyenne, c'est générique.
Ce guide, c'est tout ce qu'on applique chez OOO pour que nos apps aient l'air faites par un designer : la méthode, les règles, les prompts, et le fichier DESIGN.md à copier en bas de page.
La méthode en 4 étapes
- Choisir une DA de référence. Une seule, éprouvée, dans ta niche.
- Écrire les règles. Dans un fichier que Claude lit à chaque fois, pas dans tes prompts.
- Construire avec des briques éprouvées. Composants, icônes, graphiques déjà bien dessinés.
- Passer l'aspirateur. Retirer ce que l'IA a empilé, puis relire avec la checklist.
Étape 1 · Choisir une DA de référence avec Refero Styles
styles.refero.design recense les systèmes de design de vrais produits : Apple, OpenAI, Figma, Cursor, Raycast, Superhuman, Wise, Brex, ElevenLabs, Perplexity, Intercom…
Chaque style donne les couleurs, la typographie, les espacements, les composants, et surtout un DESIGN.md que ton IA peut suivre, prévu pour Claude Code.
✅ Checklist
- Choisir un style proche de ton produit. Un outil métier dense : regarde du côté de Raycast, Cursor ou Superhuman. Une app grand public ou une fintech : plutôt Wise ou Apple.
- Ne pas en mélanger trois. Un mélange de DA, c'est l'assurance d'un résultat incohérent.
- Récupérer son DESIGN.md et le poser à la racine de ton projet.
- Garder ta couleur de marque : tu empruntes la structure (typo, rythme, rayons, ombres), pas l'identité.
- Ajouter une ligne dans ton
CLAUDE.md: « Avant de toucher à une interface, lis DESIGN.md et respecte-le. »
Ce qu'ont en commun les meilleures DA
En parcourant les styles les mieux notés, on retrouve toujours les mêmes choix :
- Une palette retenue. Des neutres, et une seule couleur d'accent, utilisée avec parcimonie.
- Une ou deux polices maximum, avec une vraie échelle de tailles.
- Des titres serrés (interlettrage légèrement négatif) et un texte courant aéré.
- Des surfaces superposées plutôt que des ombres partout : la profondeur vient du fond, pas de l'effet.
- Beaucoup d'espace. C'est le vide qui donne l'impression de qualité.
Étape 2 · Les règles
Deux niveaux : les règles de base, valables pour n'importe quelle interface, puis les règles davinci, notre skill maison tiré du SaaS OOO.
Les règles de base
1. Une grille de 4 px. Tous les espacements sont des multiples de 4 : 4, 8, 12, 16, 24, 32, 48. Plus de 13 px ici et 17 px là.
2. Un seul axe d'alignement. Tout s'aligne sur la même verticale à gauche. Un élément décalé de 3 px se voit, même si on ne sait pas dire pourquoi.
3. Le contraste. Texte lisible sur son fond (ratio 4,5:1 minimum pour le texte courant). Le gris clair sur blanc, c'est joli en maquette et illisible en vrai.
4. Une action principale par écran. Un seul bouton plein. Les autres sont secondaires (bordés) ou des liens.
5. L'espace plutôt que les cadres. Pour séparer deux blocs, ajoute de l'espace avant d'ajouter une bordure. Jamais de carte dans une carte dans une carte.
6. Des lignes de texte courtes. 60 à 75 caractères par ligne pour un paragraphe. Au-delà, l'œil se perd.
7. La cohérence. Même usage, même composant. Si un bouton « Enregistrer » est une pilule pleine à un endroit, il l'est partout.
8. Tous les états. Survol, focus, désactivé, chargement, vide, erreur. Claude ne dessine souvent que l'état « tout va bien ».
9. Le mobile. Teste chaque écran à 375 px de large. Pas de défilement horizontal, des zones cliquables d'au moins 44 px.
Les règles davinci
La typographie
- Une seule famille (on utilise Geist), en 4 graisses : 400, 500, 600, 700.
- Des tailles en pixels exacts, pas
text-smpartout. Une app vit entre 10 et 15 px, et les demi-pixels comptent :- Titre de page : 44 à 52 px, graisse 600, interlettrage -3 %.
- Chiffre clé : 36 px.
- Titre de carte ou de modale : 17 à 20 px.
- Corps de texte : 14 à 15 px.
- Listes, tableaux, menus : 12,5 à 13 px. C'est la taille la plus utilisée de l'app.
- Méta, dates : 11,5 à 12 px.
- Label de section : 11 px en majuscules, espacé.
- La hiérarchie passe par la taille et le gris, pas par la couleur. Trois tons de texte suffisent : principal, secondaire, discret.
- Tous les nombres en chiffres tabulaires : les colonnes s'alignent et rien ne saute quand un compteur bouge.
- Les sous-titres tiennent sur une ligne. Titres en minuscules (sauf la première lettre).
La couleur
- Une seule couleur d'action. Elle sert aux boutons principaux, au lien actif, au focus. Un mot par écran maximum dans un titre.
- Les neutres passent par des rôles (fond, surface, texte, texte secondaire, bordure), jamais par des gris codés en dur. C'est ce qui permet d'avoir un mode clair et un mode sombre propres.
- Les bordures sont la couleur du texte à 8 % d'opacité (15 % au survol). Elles marchent en clair comme en sombre.
- Les statuts (succès, alerte, erreur) : fond teinté à 10 %, bordure à 25 %, texte plein. Jamais d'aplat saturé.
- Le mot mis en avant dans un titre est en gris secondaire, pas en couleur, pas en dégradé.
Les icônes
- Un seul set : Lucide. Zéro emoji dans l'interface.
- Plus l'icône est petite, plus son trait est épais : trait de 1,5 à 22 px, de 2 à 14 px, de 3 à 11 px. C'est ce qui garde un poids visuel constant.
- Un bouton qui ne contient qu'une icône a toujours un
aria-label.
Les formes
- Boutons en pilule (
rounded-full), 14 px, graisse 500. - Rayons cohérents : 8 px pour les petits boutons, 12 px pour les champs, 16 px pour les menus, 18 px pour les cartes et les modales.
- Plat par défaut. Une carte de contenu a une bordure, pas d'ombre, et ne bouge pas au survol. Seules les cartes cliquables se soulèvent de 2 px.
- L'ombre est réservée à ce qui flotte : menus, modales, sidebar. Et elle reste sous l'objet (spread négatif) au lieu de baver autour.
- Le flou d'arrière-plan est réservé aux overlays.
Le mouvement
- Deux courbes, pas
ease-in-outpartout :cubic-bezier(0.22, 1, 0.36, 1)pour les entrées et les survols ;cubic-bezier(0.32, 0.72, 0, 1)pour les menus et les panneaux.
- Des durées courtes : 150 ms pour une couleur, 180 ms pour un menu, 240 ms pour une entrée de page. Au-delà de 250 ms, une animation devient une attente.
- De petits déplacements : 4 à 6 px, jamais de zoom de plus de 2 %.
- Un retour immédiat au clic (léger enfoncement, barre de chargement) passe avant la jolie transition.
- Des squelettes de chargement avec un reflet qui balaie, pas un spinner au milieu de la page.
- Pas d'animation décorative dans une app (flottement, respiration). C'est pour les landing pages.
- Toujours respecter
prefers-reduced-motion.
Le menu
- Une sidebar flottante : une carte détachée des bords de 10 px, coins arrondis, qui se replie en rail d'icônes.
- Les icônes ne bougent pas pendant le repli, seuls les libellés disparaissent.
- Le lien actif a un fond légèrement teinté et une petite barre à gauche.
- L'état replié est posé avant le premier affichage : rien ne saute au chargement.
Étape 3 · Les bonnes briques
Ne demande pas à Claude de dessiner un graphique ou un bouton à partir de rien. Donne-lui des briques déjà bien faites :
- shadcn/ui : les composants de base (boutons, modales, menus, tableaux) et les graphiques pour les dashboards.
- Lucide : les icônes.
- Aceternity UI et Kokonut UI : des sections plus travaillées, surtout pour les landing pages.
- Motion : les animations, quand tu en as vraiment besoin.
Et précise-le dans tes règles : « Utilise les composants shadcn/ui existants avant d'en créer un nouveau. »
Étape 4 · Passer l'aspirateur
L'IA a trois réflexes qui encombrent un écran : elle explique (comment ça marche, d'où viennent les données), elle affiche tout ce qu'elle a (chaque champ devient un badge) et elle met en gros ce qui est facile à compter plutôt que ce qui compte.
Une app propre, c'est d'abord une app où on a retiré la moitié de ce que l'IA avait mis. Sans supprimer une seule fonctionnalité : on retire de l'affichage, on réduit, on replie.
Les 4 questions, pour chaque élément de l'écran
- Quelle décision ou quelle action ça aide, ici, maintenant ? Aucune : on retire ou on replie.
- L'utilisateur le sait-il déjà ? Oui : on retire.
- C'est utile tout le temps, ou seulement parfois ? Parfois : on le met au survol, dans une infobulle ou une section repliée.
- Sa taille correspond-elle à son importance ? Non : on réduit.
Les budgets par écran
| Élément | Maximum |
|---|---|
| Titre de page | 1, 3 mots |
| Sous-titre | 1 ligne, 60 caractères |
| Bouton principal | 1 |
| Cartes de chiffres en haut | 4 |
| Indicateurs par ligne de liste | 2 |
| Texte d'aide permanent | 0 (sauf action irréversible) |
| Encart d'astuce permanent | 0 |
Ce qu'on chasse en priorité
- Le sous-titre-paragraphe qui explique comment marche la page.
- Le texte gris sous chaque bouton : mets l'info dans le libellé du bouton.
- Les lignes d'état techniques (« synchronisé il y a 3 h ») : en infobulle, sauf quand c'est en panne.
- Les compteurs partout : garde seulement ceux qui poussent à agir (« À traiter : 14 »).
- Les gros chiffres de vanité : le chiffre en 36 px doit répondre à « et donc, je fais quoi ? ».
- Les doublons : la même info dans la liste et dans l'en-tête.
- Les emojis décoratifs.
Les prompts
Pour démarrer un projet :
Avant toute interface, lis DESIGN.md et applique-le strictement.
Utilise les composants shadcn/ui existants et les icônes Lucide.
Couleur d'accent : [ta couleur]. Aucune autre couleur en dur.
Commence par le shell (sidebar flottante + en-tête de page), puis
montre-moi une page de test avec : un titre, 4 cartes de chiffres,
une liste, une modale, un état vide et un squelette de chargement.
Pour retoucher un écran existant :
Reprends l'écran [chemin] en respectant DESIGN.md.
1. Liste chaque élément visible et dis s'il faut le garder, le réduire,
le replier ou le retirer, avec la raison.
2. Applique sans supprimer aucune fonctionnalité.
3. Vérifie la checklist de DESIGN.md et dis-moi ce qui ne passe pas.
Pour t'inspirer d'une capture :
Voici une capture de [produit]. N'en copie pas les couleurs.
Reprends la structure : hiérarchie, espacements, rayons, densité.
Explique-moi ce que tu en retiens avant de coder.
Ce qui ne marche pas : « fais-le propre », « rends-le moderne », « plus pro ». Claude ne sait pas ce que ça veut dire pour toi. Donne-lui une règle, une référence ou une capture.
Les erreurs typiques de Claude, et la correction
| Ce que Claude fait par défaut | Ce qu'il faut |
|---|---|
| Dégradé violet-bleu | Ta couleur, en aplat, sur les actions seulement |
| Emojis dans les titres | Icônes Lucide, ou rien |
| Une ombre sous chaque carte | Une bordure à 8 %, l'ombre pour ce qui flotte |
text-sm partout |
Une échelle de tailles en px |
| Trois polices | Une seule famille |
| Des badges pour chaque champ | 2 indicateurs par ligne maximum |
| Un paragraphe sous le titre | 1 ligne, ou rien |
| Un spinner au milieu | Un squelette de la page |
| Des coins arrondis au hasard | 8 / 12 / 16 / 18 px selon l'élément |
| Des animations de 500 ms | 150 à 250 ms |
| Bleu par défaut sur les liens | La couleur d'accent, ou le texte principal souligné |
Installer davinci et aspirateur dans Claude Code
Plutôt que de répéter ces règles, mets-les dans des skills : Claude les charge tout seul dès qu'il touche à une interface.
- davinci décide comment on affiche : Télécharger davinci
- aspirateur décide quoi afficher : Télécharger aspirateur
Décompresse chaque archive dans ~/.claude/skills/, relance Claude Code, puis tape /davinci ou /aspirateur. Tu peux aussi simplement dire « fais-le propre » ou « il y a trop d'infos » : les skills se déclenchent seuls.
Pas envie d'installer des skills ? Copie le fichier DESIGN.md ci-dessous à la racine de ton projet : il contient l'essentiel des deux.
La checklist avant de livrer un écran
- Une seule police, des tailles de l'échelle, les nombres en chiffres tabulaires.
- Des icônes Lucide, aucun emoji.
- Aucune couleur neutre en dur. Testé en clair et en sombre.
- La couleur d'accent seulement sur l'action principale et les repères.
- Boutons en pilule, rayons cohérents.
- Des cartes plates, une ombre seulement sur ce qui flotte.
- Un squelette de chargement et un retour visible au clic.
- Des animations sous 250 ms.
- Un sous-titre d'une ligne maximum, aucun texte d'aide inutile.
- Testé à 375 px de large.












