CommunityImagegithub.com

Isometrics

Dessinez et animez des objets isométriques au style contour ("Line") en React + SVG pour les états vides, les états bloqués et les illustrations ponctuelles, avec des calculs isométriques précis, un contour de 1 px, une marque de marque et un seul mouvement, vérifié par rendu et captures d'écran. À utiliser lorsque l'utilisateur demande une illustration isométrique, une icône ou un objet isométrique, une illustration d'état vide ou bloqué, des "isometrics" d'un sujet (par exemple, "gallery isometrics", "an isometric inbox"), ou un dessin isométrique au trait/contour avec animation.

Qu'est-ce que Isometrics ?

Isometrics est une compétence dédiée à la création d'illustrations isométriques au style contour ("Line") pour des composants React. Son objectif principal est de produire des états vides, bloqués ou des illustrations ponctuelles avec un rendu cohérent : un seul objet, un contour de 1 px, un fond blanc cassé, une petite marque aux couleurs de la marque, et un unique mouvement subtil. La compétence repose sur des mathématiques isométriques strictes (angles à 30° sur l'horizontale, pas de projection 2:1) et garantit l'uniformité visuelle entre tous les objets générés. Le flux de travail en cinq étapes guide l'utilisateur de l'interprétation du brief jusqu'au rendu final vérifié. Il commence par l'analyse du sujet, de l'usage (état vide, bloqué, etc.) et du message. Ensuite, trois concepts sont proposés dans un tableau, avec une recommandation. La phase de construction décompose l'objet en primitives 3D (Extrude, Slice, etc.) sur une grille de 0.5 unités, et le mouvement est intégré via une storyboard commentée. Enfin, un script Playwright vérifie automatiquement la qualité du rendu (épaisseur du trait, centrage, animation) et génère une "feuille" de contrôle visuelle. Les règles de conception sont très strictes : l'objet doit être lisible à 120 px, éviter les formes accidentelles de visage, utiliser un seul contour partout, et respecter une hiérarchie de détails (forme, parties reconnaissables, détails discrets). La compétence est destinée aux développeurs React utilisant Tailwind CSS, shadcn/ui et la bibliothèque `motion`. L'ensemble du processus est conçu pour éviter les erreurs courantes (doubles contours, objets trop plats, etc.) grâce à une liste de vérification exhaustive et à des règles non négociables.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/craftUI012/Skills/tree/main/isometrics

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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

FichierQuand le lire
SKILL.mdtoujours : 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.mdpendant la construction : le moteur et le kit Line
references/isometric-math.mdlorsqu'une forme nécessite des calculs que le moteur ne possède pas
examples/*.tsxavant de construire : commencer par le plus proche
engine/iso-core.tsx, engine/iso-line.tsxcopié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.

  1. Vérifiez la présence de components/isometrics/iso-core.tsx. S'il manque, copiez engine/iso-core.tsx et engine/iso-line.tsx de cette compétence dans components/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).

  2. 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.

  3. Pour le vérificateur, Playwright : npm i -D playwright et npx playwright install chromium (ou il utilisera un Chrome installé).

  4. Une page pour rendre un objet seul, enveloppé dans PlayOnHover (le vérificateur le joue en survolant), par exemple app/isometrics-preview/<name>/page.tsx dans 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 :

ObjetMessage (titre)Le mouvement unique
A ★………
B………
C………

Chaque concept doit réussir les quatre tests :

  1. Se lit en contour à 120 px. Une silhouette que les gens reconnaissent sans couleur.
  2. 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.
  3. 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).
  4. 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) sont view="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

  1. Commencez par l'exemple le plus proche dans examples/ (tableau ci-dessous). Gardez sa structure : storyboard, TIMING, géométrie, pistes, poses, morceaux, LineState.

  2. 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 active est 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 dans lines-marked.png) ;
    • sa taille optique correspond à l'ensemble (√(l×h) 140–175 px).
  3. Regardez sheet.png et lines.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.

  4. 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.

  5. 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.

ErreurRègle désormais
Les boîtes dessinées de face ressemblaient à des autocollants platsChoisissez 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 salesPas 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 ensembleTaille optique 140–175 px via defaultArtClassName
Les pages volaient 3 unités en dehors du cadreLe 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 visageRecherchez les visages accidentels à la taille d'une vignette
Un coin qui se rabat vers le spectateur était invisible de faceLes 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étriqueEn 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 lectureLes 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 finLes parois robustes ont une épaisseur (≥ 0.5) ; les faces fines sont pour le papier
Chaque objet était beau seul, l'ensemble ne l'était pasPassez 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 courbesDe 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 épaisseLe 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'arcUne porte de la forme de son ouverture partage un seul contour au repos
Une porte de coffre-fort à 32° en isométrique paraissait de profilLes 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éesDé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 lignesDessinez les marques comme des formes avec des espaces clairs ; évitez les glyphes d'espacement dans le texte

Règles non négociables

  1. Isométrie vraie uniquement. Axes à 30° de l'horizontale, à 120° les uns des autres, échelle égale. Jamais la projection "jeu" 2:1 (26.565°).
  2. Géométrie d'abord. Placez les primitives en unités mondiales. N'écrivez jamais un chemin d'écran projeté à la main.
  3. Une seule grille. Positions et tailles en unités mondiales de 0.5 ; détails de face en 0.25.
  4. 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é.
  5. 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 suit tone (par défaut primary).
  6. 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 contenu title : c'est le nom accessible.
  7. Accessible et intégrable. L'illustration est décorative sauf si title est fourni ; elle est alors un graphique d'état.
  8. 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).
  9. Les changements de taille sont saufs. La fonction Scale modifie uniquement la largeur et la hauteur (pas la profondeur en view="isometric"). Utilisez-la comme dernier recours ; préférez les primitives redimensionnées.
  10. La feuille est la source de vérité. Après le vérificateur, regardez sheet.png et lines.png. Si le design ne convient pas, corrigez et relancez le vérificateur.

Exemples

ExempleCe qu'il montreBon point de départ pour
examples/map-pin.tsxUn objet isométrique au style contour, simple, avec un mouvement uniqueLa plupart des objets simples avec un seul mouvement
examples/empty-inbox.tsxUn état vide avec un plateau, plusieurs parties animées en séquenceÉtats vides avec un plateau ou un conteneur
examples/printer.tsxUn objet isométrique volumineux avec plusieurs détails et un tiroir coulissantObjets avec des parties mobiles et des détails
examples/folder.tsxUn objet plat vu de face avec un mouvement de rabatObjets plats (papier, dossiers, badges)
examples/server-rack.tsxUn objet isométrique vertical avec plusieurs niveaux et un voyantObjets 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).

Skills associés