Isometrics (style Line)
Vous transformez un brief succinct ("gallery isometrics", "un état de boîte de réception vide") en un objet dessiné et animé qui est livré comme un état complet : l'illustration, un titre, une ligne de texte et un bouton. Chaque objet est construit à partir de primitives 3D en unités mondiales et projeté en isométrie vraie, de sorte qu'il partage une grille, un contour et un aspect avec tous les autres objets créés avec cette compétence.
Le style, en une ligne : un objet, vu de face s'il est plat ou sous l'angle isométrique vrai s'il est volumineux, un contour de 1 px sur des faces blanc cassé, une petite marque aux couleurs de la marque, pas d'ombre, pas de lueur, un seul mouvement, puis l'immobilité.
Vous ne sautez pas d'étapes. Vous ne considérez pas un objet comme terminé tant que le vérificateur (checker) n'a pas réussi et que vous n'avez pas examiné sa feuille.
Contenu
| Fichier | Quand le lire |
|---|---|
SKILL.md | toujours : le flux de travail et les règles |
references/brief-to-concept.md | étapes 1–2 : transformer un brief vague en trois concepts |
references/motion.md | étape 4 : choisir et chronométrer le mouvement |
references/line-style.md | étapes 3–5 : toutes les règles de dessin, à faire et à ne pas faire, avec la raison |
references/engine-api.md | pendant la construction : le moteur et le kit Line |
references/isometric-math.md | lorsqu'une forme nécessite des calculs que le moteur ne possède pas |
examples/*.tsx | avant de construire : commencer par le plus proche |
engine/iso-core.tsx, engine/iso-line.tsx | copiés une fois dans le projet de l'utilisateur |
scripts/check.mjs | étape 5 : la vérification stricte du rendu |
Configuration (une fois par projet)
Les objets sont des composants React client pour un projet avec Tailwind CSS et shadcn/ui (ils utilisent @/lib/utils cn et @/components/ui/button) ainsi que le package motion.
-
Vérifiez la présence de
components/isometrics/iso-core.tsx. S'il manque, copiezengine/iso-core.tsxetengine/iso-line.tsxde cette compétence danscomponents/isometrics/(ou le dossier préféré de l'utilisateur ; les objets les importent de manière relative, ils vivent donc tous dans un seul dossier). -
Si le projet n'a pas
motion: installez-le (npm i motion, ou le gestionnaire de paquets du projet). S'il n'a pas le bouton shadcn :npx shadcn@latest add button. -
Pour le vérificateur, Playwright :
npm i -D playwrightetnpx playwright install chromium(ou il utilisera un Chrome installé). -
Une page pour rendre un objet seul, enveloppé dans
PlayOnHover(le vérificateur le joue en survolant), par exempleapp/isometrics-preview/<name>/page.tsxdans Next.js, ou une route dans le routeur du projet :import { PlayOnHover } from "@/components/isometrics/iso-line"; import { MapPin } from "@/components/isometrics/map-pin"; export default function Page() { return ( <main className="flex min-h-svh items-center justify-center p-10"> <PlayOnHover><MapPin /></PlayOnHover> </main> ); }Créez-la par objet ; dites à l'utilisateur qu'il s'agit d'une page d'aperçu qu'il peut supprimer.
Ne modifiez jamais le moteur pour faire fonctionner un objet. Si une forme manque vraiment, ajoutez une aide à l'intérieur du fichier de l'objet, construite à partir de la 3D, et informez l'utilisateur.
Le flux de travail
Étape 1 · Lire le brief
Transformez la demande en trois réponses avant toute autre chose :
- Sujet : la chose ou le thème ("galerie" → photos, albums, images).
- Usage : l'état qu'il sert : vide (rien ici pour l'instant), bloqué (pas d'accès, éteint, pas connecté, introuvable), rien trouvé (recherche, filtres), succès / tout va bien, ou une illustration ponctuelle dans une carte de fonctionnalité.
- Message : une phrase simple que l'état exprime ("Vous n'avez pas encore de photos").
Si l'usage n'est pas indiqué, le brief correspond généralement à plusieurs cas ; c'est à cela que servent les concepts. Voir references/brief-to-concept.md.
Étape 2 · Trois concepts, puis attendez
À moins que le brief ne nomme déjà un objet et un état, montrez à l'utilisateur trois concepts sous forme de tableau et arrêtez-vous et attendez son choix :
| Objet | Message (titre) | Le mouvement unique | |
|---|---|---|---|
| A ★ | … | … | … |
| B | … | … | … |
| C | … | … | … |
Chaque concept doit réussir les quatre tests :
- Se lit en contour à 120 px. Une silhouette que les gens reconnaissent sans couleur.
- Les arrondis l'emportent sur les angles. Les objets arrondis sont perçus comme plus amicaux en ligne ; une boîte simple ressemble à un colis ou à un fil de fer.
- Un seul objet. Pas une scène, pas un tas. Une deuxième petite partie est acceptable uniquement si elle appartient à l'objet (un couvercle, un drapeau, une main).
- Le mouvement exprime le message. L'animation est le verbe de la phrase (voir
references/motion.md). Si vous ne pouvez pas nommer le mouvement, c'est le mauvais objet.
Marquez votre recommandation avec ★ et expliquez pourquoi en une ligne. Variez les trois : objets différents, mouvements différents. Lorsque le brief est précis ("un état de boîte de réception vide avec un plateau"), sautez le tableau, énoncez votre choix et le mouvement, et continuez.
Étape 3 · Décomposer l'objet en parties
Écrivez un tableau des parties en unités mondiales avant le code : chaque partie, la primitive à partir de laquelle elle est construite (Extrude, Slice, Ring, FacePath, Box…), sa taille et sa position sur la grille de 0.5, si elle bouge, et quelle partie est la marque de marque. Ensuite, le texte : titre (≤ 28 caractères), une ou deux phrases, libellé du bouton (≤ 22 caractères) et son icône (l'icône suit le verbe : un plus uniquement là où l'action ajoute).
Règles qui déterminent les parties (toutes dans references/line-style.md) :
- Choisissez d'abord la vue. Les choses plates ou fines (une page, un badge, un disque) sont
view="front"; les choses volumineuses ou profondes (une imprimante, une boîte, un serveur, un plateau, un bâton posé sur un bureau) sontview="isometric". Les boîtes vues de face ressemblent à des autocollants plats avec des lignes doublées. - Construisez en faisant face à +y autour de x = 0, reposant sur z = 0.
- Trois niveaux de détail : la forme, les parties par lesquelles on la reconnaît, et les marques discrètes (vis, évents, coutures, une étiquette).
- Lignes propres : un solide vu de face n'a pas de profondeur ou en a une claire (bande ≥ ~4 px) ; une partie est affleurante ou ≥ 0.5 en relief ; les empilements ronds partagent un même rayon avec une seule ligne de jointure.
- Les choses plates (papier, étiquettes, écrans) sont des faces, pas des solides.
- Les solides ronds sont des tranches entre des cercles de niveau, peints du bas vers le haut.
- Un contour qui n'est pas convexe nécessite que son bord lointain soit dessiné.
- Une partie qui glisse hors d'un boîtier est coupée au niveau du boîtier, pas flottante.
- Une seule marque de marque (palette
main) ; tout le reste est du papier (surface).
Étape 4 · Choisir et écrire le mouvement
Choisissez le mouvement à partir du message (references/motion.md), puis écrivez le commentaire du storyboard en haut du fichier avant le code de dessin : temps, ce qui bouge, de quelle distance, pourquoi. Chaque valeur dans une constante nommée. Le mouvement attend 400 ms après que l'élément soit apparu à l'écran, dure 1.2–2.4 s et se joue une fois. Lorsque le code de l'utilisateur passe active, il se joue chaque fois que active devient vrai (avec un délai de 80 ms), jamais tout seul. En mouvement réduit, on affiche la pose de repos.
Étape 5 · Construire, rendre, vérifier, regarder, corriger
-
Commencez par l'exemple le plus proche dans
examples/(tableau ci-dessous). Gardez sa structure : storyboard, TIMING, géométrie, pistes, poses, morceaux,LineState. -
Rendez-le sur sa page d'aperçu et lancez le vérificateur :
node <skill>/scripts/check.mjs http://localhost:3000/<preview-path>/<name> --duration <temps_attente+animation ms>Il rend en mode clair et sombre, joue l'animation en survolant l'élément sur une horloge simulée (la page d'aperçu doit donc envelopper l'objet dans
<PlayOnHover>), enregistre les images à 0, 25, 50, 75, 100 % et après, et vérifie :- pas d'erreur d'hydratation ou de console, en mode clair, sombre et mouvement réduit ;
- il se joue quand
activeest vrai, et il n'y a pas de bouton à l'intérieur de l'illustration ; - le mouvement revient exactement à sa pose de repos ;
- le mouvement réduit est immobile, montre la pose de repos, ignore
active; - chaque contour fait environ 1 px ; pas de filtres, lueur, ombres ou dégradés ;
- le dessin au repos tient dans son cadre ;
- le dessin est centré sur le titre à 2 px près ;
- lignes propres : au maximum 6 % du contour en doubles persistants (deux lignes distantes de 0.5–2 px sur une longueur réelle ; les petites taches aux intersections ne comptent pas), en sombre à 4× (
lines.png, les doubles en rouge danslines-marked.png) ; - sa taille optique correspond à l'ensemble (√(l×h) 140–175 px).
-
Regardez
sheet.pngetlines.png(ouvrez les deux) et parcourez la liste de contrôle ci-dessous. Le vérificateur ne voit pas le design ; c'est vous qui le faites. -
Corrigez et relancez. Au maximum trois tentatives. Si quelque chose n'est toujours pas satisfaisant après trois essais, arrêtez et dites exactement à l'utilisateur quoi, avec la feuille.
-
Rapportez : le concept, le storyboard, le résultat du vérificateur, ce que vous avez corrigé après avoir regardé, ce qui n'est toujours pas satisfaisant, et le chemin de la feuille.
Regarder la feuille : la liste de contrôle
Lisibilité
- Sans le titre, un étranger nommerait-il l'objet à la taille d'une vignette ?
- Rien ne ressemble accidentellement à un visage (deux parties rondes au-dessus d'une courbe).
- La marque de marque est une petite partie, et c'est la partie sur laquelle l'œil doit se poser.
Repos droit
- Au repos, chaque verticale est verticale et chaque bord horizontal ; rien ne penche, rien ne pend de travers, les secondes feuilles sont décalées, pas tournées.
- La pose de repos est identique à la pose en mouvement réduit (le vérificateur compare les pixels ; vous vérifiez qu'elle a l'air intentionnelle).
Lignes (regardez lines.png : sombre, 4×)
- Une seule épaisseur de contour partout ; pas de bords doublés, pas de jointures capillaires entre les remplissages, pas de bords lointains manquants sur les contours courbes, pas de remplissage dépassant du contour, pas de ligne se terminant dans le vide.
- Chaque partie est affleurante ou clairement en relief (≥ 0.5) ; pas de fines bandes.
Réalisme
- La bonne vue : les choses plates vues de face, les choses volumineuses en isométrique.
- Trois niveaux : forme, parties reconnaissables, marques discrètes. Est-ce que quelqu'un qui en possède une dirait "oui, c'est une imprimante" ?
- La bande supérieure (épaisseur vue de 30° au-dessus) est présente sur les solides et absente sur les faces fines.
Animation
- Le mouvement exprime le message ; chaque mouvement est causé par le précédent (un retard, un suivi, un stabilisation).
- Les parties articulées ne traversent jamais leur boîtier ; les pointes ne traversent jamais la pose de repos ; les balancements restent petits (≤ 6° sur une partie suspendue, ≤ 25° sur un rabat).
- Rien n'apparaît ou ne disparaît en fondu ; les choses qui apparaissent grandissent avec une échelle.
S'adapte à la page
- Centré sur le texte ; le cadre n'est pas rembourré d'espace vide.
- A un bon rendu en sombre : les faces papier deviennent du papier foncé, la marque de marque reste la marque.
Plus jamais ça : les erreurs commises par cette compétence
Chacune de ces erreurs a été livrée une fois, a été repérée en relecture, et est maintenant une règle. Avant de rapporter un objet, vérifiez-le par rapport à chaque ligne.
| Erreur | Règle désormais |
|---|---|
| Les boîtes dessinées de face ressemblaient à des autocollants plats | Choisissez d'abord la vue : les choses plates de face, les choses volumineuses view="isometric" (line-style.md) |
| Les fines bandes supérieures, les parties à peine en relief et les anneaux étagés ont dessiné des lignes doublées et sales | Pas de fines bandes ; affleurant ou ≥ 0.5 en relief ; empilements ronds à un seul rayon ; le test de lignes propres du vérificateur doit réussir, et vous regardez lines.png (sombre, 4×) |
| Les objets n'étaient qu'un contour ("pas réaliste") | Trois niveaux de détail : forme, parties reconnaissables, marques discrètes |
| Les tailles variaient entre les objets d'un même ensemble | Taille optique 140–175 px via defaultArtClassName |
| Les pages volaient 3 unités en dehors du cadre | Le mouvement reste dans l'espace aérien de l'illustration ; au maximum un peu au-delà du bord du cadre |
| Deux loquets, une bande pleine largeur comme "une marque de marque" | Une petite marque, vraiment une seule |
| Une fente sur un point, deux loquets sur une couture ressemblaient à un visage | Recherchez les visages accidentels à la taille d'une vignette |
| Un coin qui se rabat vers le spectateur était invisible de face | Les virages vers le spectateur ne se lisent qu'à une fraction de leur angle ; préférez les mouvements dans le plan de l'image, ou allez grand (motion.md) |
| Une page inclinée dans son plan se cisaillait à l'angle isométrique | En vue isométrique, faites tourner une partie uniquement autour de sa propre normale ou d'une charnière sur son bord (motion.md) |
| Une partie a clignoté à sa pose de départ lors de la première lecture | Les parties pilotées par l'état du compteur se réinitialisent lorsque le clip change et commencent au repos lorsqu'elles sont maintenues (engine-api.md) |
| Les parois fines d'un plateau ressemblaient à du plastique fin | Les parois robustes ont une épaisseur (≥ 0.5) ; les faces fines sont pour le papier |
| Chaque objet était beau seul, l'ensemble ne l'était pas | Passez en revue tout le lot côte à côte, en mode clair et sombre, avant de rapporter |
| Le corps d'une cloche, un étrier, une aiguille ont dessiné des contours doublés le long de leurs courbes | De face, une partie courbe est une face plate (ou clairement profonde) ; donnez à une aiguille des côtés parallèles, jamais une conicité |
| Du sable dessiné sur le contour du verre a fait une seule traînée épaisse | Le contenu se trouve à l'intérieur d'une paroi en retrait, jamais sur le contour du contenant |
| Une porte à 0.25 en relief de sa boîte a doublé l'arc | Une porte de la forme de son ouverture partage un seul contour au repos |
| Une porte de coffre-fort à 32° en isométrique paraissait de profil | Les portes et couvercles isométriques s'ouvrent d'environ 24–26° pour que leur face reste lisible |
| Un porte-clés reposait sur les clés au lieu de passer à travers leurs trous ("l'anneau n'est pas à l'intérieur du porte-clés") | Les parties enfilées s'entrelacent : l'anneau passe derrière chaque partie d'un côté de son trou et devant de l'autre (line-style.md) |
| Réduire un objet à sa taille a fait réapparaître les lignes doublées | Définissez d'abord la largeur par défaut, puis faites des bandes ≥ 0.5 pour les objets dessinés petits |
| Un badge "!!!" a échoué au test de lignes | Dessinez les marques comme des formes avec des espaces clairs ; évitez les glyphes d'espacement dans le texte |
Règles non négociables
- Isométrie vraie uniquement. Axes à 30° de l'horizontale, à 120° les uns des autres, échelle égale. Jamais la projection "jeu" 2:1 (26.565°).
- Géométrie d'abord. Placez les primitives en unités mondiales. N'écrivez jamais un chemin d'écran projeté à la main.
- Une seule grille. Positions et tailles en unités mondiales de 0.5 ; détails de face en 0.25.
- Un seul style.
variant="ink"(par défaut) ou"line"; ne mélangez jamais les styles dans un objet. Contour de 1 px, parois en papier, pas d'ombre, pas de lueur, pas de dégradé. - Thème à partir des tokens. Les couleurs proviennent uniquement du thème shadcn de l'utilisateur via les variables
--iso-*. Pas de hex, pas d'oklch dans un fichier d'objet. La marque de marque suittone(par défautprimary). - Props, pas de forks. La copie, le ton, la variante, l'épaisseur du trait, les commutateurs d'animation sont des props avec des commentaires de doc (
LineStateProps). Ne nommez jamais une prop de contenutitle: c'est le nom accessible. - Accessible et intégrable. L'illustration est décorative sauf si
titleest fourni ; elle est alors un graphique d'état. - Une seule page. Chaque objet est enregistré dans son propre fichier dans
components/isometrics/et exporté en tant que composant nommé portant le nom de l'objet (en PascalCase). - Les changements de taille sont saufs. La fonction
Scalemodifie uniquement la largeur et la hauteur (pas la profondeur enview="isometric"). Utilisez-la comme dernier recours ; préférez les primitives redimensionnées. - La feuille est la source de vérité. Après le vérificateur, regardez
sheet.pngetlines.png. Si le design ne convient pas, corrigez et relancez le vérificateur.
Exemples
| Exemple | Ce qu'il montre | Bon point de départ pour |
|---|---|---|
examples/map-pin.tsx | Un objet isométrique au style contour, simple, avec un mouvement unique | La plupart des objets simples avec un seul mouvement |
examples/empty-inbox.tsx | Un état vide avec un plateau, plusieurs parties animées en séquence | États vides avec un plateau ou un conteneur |
examples/printer.tsx | Un objet isométrique volumineux avec plusieurs détails et un tiroir coulissant | Objets avec des parties mobiles et des détails |
examples/folder.tsx | Un objet plat vu de face avec un mouvement de rabat | Objets plats (papier, dossiers, badges) |
examples/server-rack.tsx | Un objet isométrique vertical avec plusieurs niveaux et un voyant | Objets avec des parties répétées et des indicateurs d'état |
Commencez toujours par l'exemple le plus proche et conservez sa structure exacte (storyboard, TIMING, constantes, géométrie, pistes, poses).