Code to Figma
Exécutez le projet, extrayez le DOM en une arborescence de mise en page dans le navigateur, puis reconstruisez-la dans Figma sous forme de Auto Layout et de composants modifiables.
Pour les interfaces web front-end. Les limites des composants disposent d'adaptateurs pour Vue 3 et React (React 18 et 19 testés, y compris les composants serveur Next.js App Router ; React 16 et 17 ont la même structure de fibres mais ne sont pas testés). Les autres frameworks bénéficient uniquement de la détection de nœuds répétés. Les applications natives et les écrans entièrement dessinés dans Canvas/WebGL ne sont pas pris en charge ; utilisez plutôt le fichier de conception ou les maquettes.
| Fichier | Contenu |
|---|---|
| web-capture.md | Le processus complet ; lisez-le avant de commencer |
| screen-structure.md | Règles de structure que la sortie doit respecter |
| scale-guard.md | Seuils et conditions d'arrêt pour le budget d'appels MCP et la mémoire du fichier ; lisez-le avant de commencer |
| troubleshooting.md | Tableau de recherche des pièges ; consultez-le lorsque les résultats sont erronés |
| examples/ | Modèles de configuration de capture pour quatre types de projet : maquette intégrée, fixture Playwright, Nuxt dev, interception de l'API backend |
| evals/trials.json | Cas de régression et références ; réexécutez-les tous après avoir modifié les outils |
Étapes
- Confirmer les entrées : le projet et comment l'exécuter, quels écrans, la zone d'affichage et le type de hauteur de chaque écran, le fichier Figma cible et le système de conception à lier. L'utilisateur décide du sujet et du périmètre ; ne les choisissez pas vous-même. Une fois que vous avez le lien Figma, exécutez
create_sessionplus unuse_figmaen lecture seule pour confirmer que le compte MCP avec lequel vous êtes connecté peut lire et écrire le fichier (s'il ne peut pas ouvrir le fichier, utilisezwhoamipour expliquer de quel compte il s'agit et avec qui partager le fichier). Estimez ensuite le nombre d'appels nécessaires pour ce travail selonscale-guard.md"Budget d'appels MCP" ; si le budget est insuffisant, dites-le d'abord - Démarrer le projet, écrire la configuration, capturer : exécutez
al-capture.cjs, en suivantweb-capture.md - Construire d'abord un écran représentatif par appareil, le comparer avec la capture d'écran du navigateur, et ne faire le lot que lorsqu'il correspond
- Comparer chaque écran après le lot : exécutez
al-diff.py; faites également une capture d'écran et vérifiez la section Composants - Auditer : exécutez
audit-screens.js
Terminé lorsque : chaque écran a une reconstruction, la largeur du cadre racine de chaque écran est égale à la zone d'affichage, et l'écran représentatif de chaque appareil possède un calque de capture d'écran de référence ; issues est vide, ou chaque entrée est signalée avec sa cause ; la section Composants a été vérifiée dans une capture d'écran.
Règles strictes pour l'écriture dans Figma
La mémoire d'un fichier Figma peut dépasser la limite instantanément, même lorsque l'utilisation statique est faible, et un fichier qui explose ne peut pas toujours être récupéré (scale-guard.md "Incident"). Suivez ces règles sur chaque projet :
- Avant d'écrire dans un fichier existant, demandez à l'utilisateur de sauvegarder une version, y compris avant de supprimer ou de reconstruire des écrans que vous avez construits précédemment. Ne commencez pas tant que l'utilisateur n'a pas répondu que c'est sauvegardé. Lorsque la page cible ne contient rien d'autre que ce que vous avez construit vous-même (nouveau fichier, page vierge), vous pouvez ignorer cette étape ; mentionnez-le dans le rapport
- Envoyez un écran à la fois : téléchargez les images et le SVG de données de cet écran, construisez-le, confirmez que les cadres temporaires
ALDATA-etALIMG-sont supprimés, puis passez au suivant. Ne téléchargez pas tout le lot d'abord - Si l'utilisateur signale un avertissement rouge ou un mode de récupération, arrêtez immédiatement. N'exécutez même pas un
use_figmaen lecture seule tant que l'utilisateur n'a pas confirmé que le fichier est correct - Arrêtez lorsque la limite d'appels est atteinte : si un outil Figma renvoie "limite d'appels d'outil MCP Figma atteinte", ne réessayez pas et ne changez pas d'outil pour contourner le problème. Listez les écrans terminés et les ID de nœuds des cadres temporaires encore sur le canevas
Limites connues
- Les limites des composants disposent d'adaptateurs pour Vue 3 et React ; les deux nécessitent le mode développement (les versions de production n'ont pas de noms de composants, et
stats.jsonémettra un avertissement). Svelte, Angular et autres frameworks bénéficient uniquement de la détection de nœuds répétés ; pour en prendre en charge un, ajoutez une entrée àADAPTERSdansal-extract.js - Règles de nommage des composants React : un nœud DOM est considéré comme une limite uniquement s'il est le seul nœud racine du composant, et le nom est tiré du composant le plus externe. Les composants qui ne font que passer des enfants (Provider, Tooltip, ErrorBoundary), les composants de style styled-components/emotion, et les composants internes du routeur et du framework ne comptent pas. Les noms des composants serveur Next.js nécessitent une version de développement React 19 (Next 15 et ultérieur) ; avec React 18, seuls les composants client sont capturés
- React : le projet de démonstration Vite + Radix + Tailwind 4 a une référence de reconstruction Figma (quatre écrans, 0,02 à 0,12 % de différence par rapport au navigateur). Le projet Next.js App Router est vérifié uniquement par la capture et l'empaquetage
- Les icônes qui utilisent un SVG comme
mask-imageet n'ont pas d'enfants (par exemple, frappe-ui, classeslucide-*d'UnoCSS) sont converties en vecteurs et colorées avec la couleur d'arrière-plan. Les autres utilisations demask-image(dégradés fondus, masques bitmap) etclip-pathn'ont pas d'équivalent ; les bords fondus et les découpes angulaires deviennent des formes pleines - Couleurs :
rgb()est pris en charge, ainsi que les formats que Chrome peut renvoyer, tels queoklch(),color(srgb …),lab()ethsl(); ces derniers sont convertis en sRGB via un canvas, et chaque canal peut être décalé de 1 (arrondi 8 bits) - L'API Plugin ne peut pas modifier la largeur d'un cadre à l'intérieur d'une instance. Un enfant unique qui s'étire pour remplir son cadre parent est modifié en Fill, les enfants qui s'étirent pour remplir le parent sont ajustés via le padding, et les cadres Auto Layout qui sont en Hug dans les données sont modifiés en Hug ; dans tous les autres cas, la taille suit le composant principal, et
log.boxesles liste - Les petits éléments avec un z-index imbriqué peuvent se retrouver cachés ; l'arborescence des calques ne peut pas déplacer un seul enfant hors de son parent
- Les polices système (
ui-sans-serif) sont remplacées par Inter ; les largeurs de caractères diffèrent légèrement font-variant-numeric: tabular-nums(chiffres tabulaires) ne peut pas être activé dans Figma :openTypeFeaturesde l'API Plugin est en lecture seule. Les dates, heures et montants apparaissent plus étroits que dans le navigateur, et le texte qui les suit se décale de 5 à 8 pixels ;log.driftles liste- La rotation et les triangles CSS ne sont gérés que pour les éléments sans enfants (marques de coche, triangles d'onglet, petits carrés), qui sont convertis en vecteurs ; les conteneurs pivotés avec des enfants sont disposés par leur boîte englobante, et leur contenu n'est pas pivoté
Rapport
- Structure : ratio de conteneurs Auto Layout, nombre de composants/variants ; quelles zones sont absolues (superpositions, contenu en cours de défilement)
- Résultats de comparaison : dérive du texte, les écrans avec le ratio de différence le plus élevé, et les points connus qui ne peuvent pas être reproduits. Lisez le ratio de différence en contexte : les dégradés ou les
mask-imagebitmap augmentent le ratio, expliquez donc la cause ; lorsquestats.jsonavertit que des icônes sont vides, autorisez la source de l'icône et recapturez d'abord. Lorsqu'un écran entier n'a presque pas de couleur, vérifiez d'abord si lestatrenvoyé par__alBuilda détecté des couleurs (troubleshooting.md) - Les captures d'écran de référence ne vont que sur les écrans représentatifs ; les autres restent dans le dossier de sortie local
- Avec une bibliothèque liée, rédigez cette partie selon la section "Rapport" de
figma-library-binding; sans bibliothèque, les couleurs et les tailles de police sont des valeurs codées en dur - Les écrans sont reproduits à partir de données fictives ; quelles zones ont été remplies avec des captures d'écran en direct, et quelle copie a été modifiée dans les maquettes
- Quelle police a été substituée lorsque Figma ne possède pas la police du produit
- Échelle : une ligne au format
scale-guard.md