Le problème avant les sites
Tu ouvres shadcn, tu copies un bouton, tu copies une card, tu copies un hero sur un autre site. Trois heures plus tard tu as une page qui ressemble à quatre pages différentes collées ensemble, et ton agent IA en rajoute une cinquième à chaque prompt parce que personne ne lui a dit à quoi le projet doit ressembler.
L'ennemi, c'est d'empiler des composants avant d'avoir figé une direction. L'ordre ci-dessous existe pour ça.
1. Refero Styles — tu figes la direction
C'est le premier onglet qu'on ouvre, avant d'écrire une ligne de code. Plus de 2 000 sites référencés, et surtout une sortie en DESIGN.md : tu choisis le site dont tu veux le style, tu récupères le fichier, tu le poses à la racine de ton projet.
À partir de là, ton agent a une référence écrite. Il ne choisit plus les couleurs, les espacements et les rayons à ta place à chaque nouvelle page.
Ce que tu fais concrètement :
- tu trouves 2 ou 3 sites dont le style colle au projet
- tu récupères le DESIGN.md
- tu le colles dans le projet (modèle à la fin de cette page)
2. shadcn/ui — la base fonctionnelle
Les composants de base : boutons, formulaires, tableaux, graphiques, dialogues. Le code arrive dans ton projet, tu le modifies, il t'appartient. C'est ce qui tient la structure.
Ce qu'on y prend : tout ce qui est fonctionnel et qu'on ne veut pas réécrire. Formulaires, navigation, tableaux de données.
Ce qu'on n'y prend pas : l'identité. shadcn par défaut, tout le monde le reconnaît au premier coup d'œil. C'est le DESIGN.md de l'étape 1 qui vient l'habiller.
3. Aceternity UI — les sections qui vendent
Plus de 100 composants animés gratuits. C'est là qu'on va chercher les hero sections, les grilles de features, les effets au scroll — tout ce qui fait la différence sur une landing page et qui est pénible à coder à la main.
La règle qu'on s'applique : deux composants animés par page, pas plus. Au-delà, la page rame et l'animation ne sert plus à rien parce qu'elle est partout.
4. Kokonut UI — quand Aceternity ne colle pas
61 composants animés gratuits, installables directement via ton agent IA. Même usage qu'Aceternity, style différent.
On l'ouvre quand le composant Aceternity ne rentre pas dans la direction du projet. Avoir deux galeries du même type, ce n'est pas du luxe : ça évite de forcer un composant qui ne va pas parce qu'on n'a pas d'autre option sous la main.
5. Motion — le détail qui termine la page
Des centaines d'animations à copier-coller ou à adapter avec ton IA. On y va en dernier, sur une page déjà finie, pour les transitions et les micro-interactions.
Si tu l'ouvres en premier, tu passes une heure sur une animation de bouton sur une page qui n'existe pas encore.
L'ordre, en une ligne
Refero Styles pour la direction → shadcn/ui pour la structure → Aceternity ou Kokonut pour les sections → Motion pour la finition.
Le prompt qu'on donne à l'agent
Une fois le DESIGN.md en place, à coller au début de ta session :
Lis DESIGN.md à la racine du projet avant toute modification d'interface.
Règles non négociables :
- Tu n'inventes aucune couleur, aucune police, aucun rayon, aucune ombre qui ne soit pas dans DESIGN.md.
- Si une valeur manque pour faire ce que je te demande, tu me poses la question au lieu de choisir.
- Tu utilises shadcn/ui pour tout composant fonctionnel (formulaire, table, dialog, navigation).
- Pour une section animée, tu me proposes le composant avant de l'installer, et tu me dis d'où il vient.
- Maximum deux composants animés par page.
Après chaque modification, tu listes les classes et variables que tu as utilisées, et tu me confirmes qu'elles viennent toutes de DESIGN.md.
Et quand tu veux ajouter un composant d'une galerie :
Installe le composant [nom] de [Aceternity UI / Kokonut UI] dans ce projet,
puis adapte-le aux variables de DESIGN.md : couleurs, police, rayon, espacement.
Ne garde aucune valeur en dur venue de la démo d'origine.
Ce que ça ne règle pas
Ça ne fait pas de toi un directeur artistique. Tu obtiens une interface cohérente et rapide à produire, pas une identité de marque — le choix du site de référence à l'étape 1 décide de 80 % du résultat, et ce choix-là, personne ne le fera à ta place.
Et un DESIGN.md ne sert à rien si tu laisses l'agent improviser une fois dessus. La contrainte tient parce qu'on la rappelle à chaque session, pas parce que le fichier existe.













