Conception & UI
Créez des interfaces qui semblent intentionnelles et premium, pas génériques comme des templates. C'est le levier de qualité le plus important dans le constructeur d'applications. Appliquez-le à l'interface DOM / superposition — pages, chrome, HUD, menus, formulaires. (Pour le canevas de jeu d'un jeu 3D, voir la compétence building-games ; cette compétence régit l'interface DOM superposée dessus.)
Lisez references/ pour approfondir (chargé à la demande — ne l'intégrez pas en entier) :
references/refined-ui.md— le système de design complet pour le chrome produit/superposition.references/typography.md— échelle typographique, association, rythme.references/surfaces.md— élévation, bordures, ombres, superposition.references/animations.md— mouvement, easing, transitions.references/performance.md— gardez l'interface fluide (60 ips, pas de saccades).
1. Design-system-first (faites cela avant de styliser quoi que ce soit)
Définissez le système une fois, puis composez à partir de lui. Ne dispersez jamais des valeurs ad-hoc.
- Tokens en CSS (Tailwind v4 est CSS-first). Mettez la palette, les rayons et les polices dans
src/styles.csssous@themeen tant que variables CSS ; consommez-les comme des utilitaires Tailwind. Une seule source de vérité.@import "tailwindcss"; @theme { --color-bg: #0b0b0f; --color-surface: #16161d; --color-fg: #e7e7ea; --color-muted: #a0a0ab; --color-primary: #14b8a6; --color-border: #26262f; --radius: 0.75rem; --font-sans: "Inter", system-ui, sans-serif; } - Utilisez les composants shadcn/ui (primitives Radix + variantes
cva+tailwind-merge) pour les boutons, dialogues, menus déroulants, champs de saisie, etc. Ils sont accessibles et cohérents. Générez-les danssrc/components/ui; stylisez via les tokens, pas via des hexadécimaux en ligne. - Correctif de base Tailwind v4 — les boutons ont besoin d'un curseur en forme de pointeur. La pré-vérification de la v4 donne au
<button>uncursor: default, ce qui semble cassé. Ajoutez ceci une fois danssrc/styles.csspour que les boutons/rôles cliquables affichent un pointeur :@layer base { button:not(:disabled), [role="button"]:not(:disabled) { cursor: pointer; } } - Interdiction du style ad-hoc : pas d'hexadécimal brut dans le JSX, pas de littéraux
text-white/bg-black, pas de valeurs arbitraires commep-[16px]outext-[13px]. Si vous avez besoin d'une valeur, elle devient un token ou un échelon d'échelle.
2. La grille d'évaluation quantifiée (règles bon marché qui empêchent le « moche »)
- ≤ 3–5 couleurs au total (une primaire + neutres + au plus une d'accent). Pas de teintes supplémentaires aléatoires. Ne choisissez pas par défaut le violet sauf si demandé.
- ≤ 2 familles de polices (souvent une). Associez une police d'affichage/titre avec une police de corps, ou utilisez-en une seule.
- Hauteur de ligne 1,4–1,6 pour le corps ; plus serrée pour les grands titres.
- Lorsque vous écrasez une couleur de fond, écrasez aussi la couleur du texte/avant-plan (le contraste doit tenir — vérifiez à la fois en mode clair et sombre).
- Mobile-first : concevez d'abord la mise en page ~390 px, puis montez en échelle. Pas de débordement horizontal ; les cibles tactiles ≥ 44 px.
- Échelle d'espacement cohérente (basée sur 4/8). L'espace blanc généreux bat le tassement.
- Un accent, utilisé avec parcimonie pour les actions principales — pas partout.
3. Anti-« slop IA » (les signes qui rendent le rendu générique — à éviter)
- Pas de remplissage par dégradé blob, pas de grands dégradés héros comme substitut au contenu.
- Pas d'emoji comme icônes — utilisez un vrai jeu d'icônes (
lucide-react). - Pas d'illustrations SVG dessinées à la main / de cartes / de graphiques — utilisez de vraies bibliothèques (
rechartspour les graphiques) ou de vraies images générées. - Pas d'images placeholder / de boîtes grises lorem dans le produit final — générez de vraies images ou utilisez du vrai contenu ; définissez
crossOrigin="anonymous"sur les images du canevas. - Évitez le look des polices trop utilisées (système par défaut uniquement, ou des choix de type Comic Sans).
- Chaque élément mérite sa place. Réduisez le bruit décoratif. Établissez un système, puis variez avec intention — pas au hasard.
- Correspondre à l'interface existante lorsque vous éditez une application en place ; n'introduisez pas un second langage visuel.
4. Mise en page & hiérarchie
- Hiérarchie visuelle claire : une action principale par vue ; la taille/le poids/la couleur expriment l'importance. Voir
references/typography.mdetreferences/surfaces.md. - Utilisez une vraie structure de mise en page (grid/flex, largeurs maximales de conteneur), pas des astuces de positionnement absolu. Alignez-vous sur une grille cohérente.
- Les états vides, les états de chargement et les états d'erreur font partie du design — ne livrez pas d'états intermédiaires vides/saccadés.
5. Mouvement (subtil, intentionnel)
- Transitions courtes et avec easing (150–250 ms) au survol/au clic/à l'entrée ; respectez
prefers-reduced-motion. Détails dansreferences/animations.md. - Ne jamais animer la mise en page d'une manière qui cause des saccades ; privilégiez transform/opacity.
6. Superpositions de jeu (lorsque cela s'associe à building-games)
Le canevas de jeu est géré par building-games. Cette compétence style la superposition DOM : écran de démarrage/« cliquer pour jouer », HUD, score, menus, pause, contrôles mobiles. Gardez la superposition lisible sur le canevas (fond, contraste) et maintenez-la en dehors du chemin de saisie du verrouillage de pointeur/du jeu.
Checklist de finition (avant de déclarer l'interface terminée)
- Tokens définis dans
@theme; pas d'hexadécimal ad-hoc / de valeurs arbitraires dans le JSX. - ≤ 5 couleurs, ≤ 2 polices, échelle d'espacement cohérente.
- Le contraste tient ; l'avant-plan est écrasé partout où le fond l'est.
- Mobile (~390 px) sans débordement ; cibles ≥ 44 px.
- Icônes/images/graphiques réels — aucun des signes de slop.
- États de chargement/vide/erreur gérés ; mouvement subtil et sûr pour
prefers-reduced-motion. - Rendu et inspecté visuellement dans un navigateur (voir vérification dans AGENTS.md), pas seulement via curl.