Code to Figma
Ejecuta el proyecto, extrae el DOM en un árbol de diseño en el navegador y luego lo reconstruye en Figma como Auto Layout y componentes editables.
Para frontends web. Los límites de componentes tienen adaptadores para Vue 3 y React (React 18 y 19 probados, incluidos Server Components de Next.js App Router; 16 y 17 tienen la misma estructura de fiber pero no están probados). Otros frameworks solo obtienen detección de nodos repetidos. Las aplicaciones nativas y las pantallas dibujadas completamente en Canvas/WebGL están fuera del alcance; usa el archivo de diseño o wireframes en su lugar.
| Archivo | Contenido |
|---|---|
| web-capture.md | El proceso completo; léelo antes de empezar |
| screen-structure.md | Reglas de estructura que debe cumplir la salida |
| scale-guard.md | Umbrales y condiciones de parada para el presupuesto de llamadas MCP y la memoria del archivo; léelo antes de empezar |
| troubleshooting.md | Tabla de errores comunes; revísala cuando los resultados sean incorrectos |
| examples/ | Plantillas de configuración de captura para cuatro tipos de proyecto: mock incorporado, fixture de Playwright, dev de Nuxt, interceptando la API del backend |
| evals/trials.json | Casos de regresión y líneas base; vuelve a ejecutarlos todos después de cambiar las herramientas |
Pasos
- Confirma las entradas: el proyecto y cómo ejecutarlo, qué pantallas, el viewport y tipo de altura de cada pantalla, el archivo Figma de destino y el sistema de diseño a vincular. El usuario decide el tema y alcance; no los elijas tú mismo. Una vez que tengas el enlace de Figma, ejecuta
create_sessionmás unuse_figmade solo lectura para confirmar que la cuenta con la que ha iniciado sesión MCP puede leer y escribir el archivo (si no puede abrir el archivo, usawhoamipara explicar qué cuenta es y con quién compartir el archivo). Luego estima cuántas llamadas necesita este trabajo según el "presupuesto de llamadas MCP" de scale-guard.md; si el presupuesto no es suficiente, dímelo primero - Inicia el proyecto, escribe la configuración, captura: ejecuta
al-capture.cjs, siguiendo web-capture.md - Construye primero una pantalla representativa por dispositivo, compárala con la captura del navegador y procesa en lote solo cuando coincida
- Compara cada pantalla después del lote: ejecuta
al-diff.py; también toma una captura y verifica la sección de Componentes - Audita: ejecuta
audit-screens.js
Terminado cuando: cada pantalla tiene una reconstrucción, el ancho del marco raíz de cada pantalla es igual al viewport, y la pantalla representativa de cada dispositivo tiene una capa de captura de referencia; issues está vacío, o cada entrada se reporta con su causa; la sección de Componentes se ha verificado en una captura.
Reglas estrictas para escribir en Figma
La memoria de un archivo de Figma puede dispararse más allá del límite en un instante, incluso cuando el uso estático es bajo, y un archivo que explota no siempre se puede recuperar (scale-guard.md "Incidente"). Sigue estas en cada proyecto:
- Antes de escribir en un archivo existente, pide al usuario que guarde una versión, incluso antes de eliminar o reconstruir pantallas que construiste antes. No empieces hasta que el usuario responda que está guardado. Cuando la página de destino no tenga nada más que lo que tú mismo construiste (archivo nuevo, página en blanco), puedes omitir esto; dímelo en el informe
- Envía una pantalla a la vez: sube las imágenes y el SVG de datos de esta pantalla, constrúyela, confirma que los marcos temporales
ALDATA-yALIMG-se hayan eliminado, luego pasa a la siguiente. No subas todo el lote primero - Si el usuario reporta una advertencia roja o modo de recuperación, detente inmediatamente. No ejecutes ni un
use_figmade solo lectura hasta que el usuario confirme que el archivo está bien - Detente cuando se alcance el límite de llamadas: si alguna herramienta de Figma devuelve "se alcanzó el límite de llamadas de la herramienta MCP de Figma", no reintentes ni cambies de herramienta para evitarlo. Enumera las pantallas completadas y los IDs de nodo de los marcos temporales que aún estén en el lienzo
Limitaciones conocidas
- Los límites de componentes tienen adaptadores para Vue 3 y React; ambos requieren modo de desarrollo (las compilaciones de producción no tienen nombres de componentes y
stats.jsonadvertirá). Svelte, Angular y otros frameworks solo obtienen detección de nodos repetidos; para admitir uno, agrega una entrada aADAPTERSenal-extract.js - Reglas de nomenclatura de componentes de React: un nodo DOM cuenta como límite solo cuando es el único nodo raíz del componente, y el nombre se toma del componente más externo. Los componentes que solo pasan hijos (Provider, Tooltip, ErrorBoundary), componentes de estilo styled-components/emotion, y componentes internos del router y del framework no cuentan. Los nombres de Server Components de Next.js requieren una compilación de desarrollo de React 19 (Next 15 y posteriores); con React 18 solo se capturan los componentes cliente
- React: el proyecto demo de Vite + Radix + Tailwind 4 tiene una línea base de reconstrucción en Figma (cuatro pantallas, diferencia del 0.02–0.12% con el navegador). El proyecto de Next.js App Router está verificado solo mediante captura y empaquetado
- Los iconos que usan un SVG como
mask-imagey no tienen hijos (por ejemplo, frappe-ui, claseslucide-*de UnoCSS) se convierten en vectores y se colorean con el color de fondo. Otros usos demask-image(degradados, máscaras de mapa de bits) yclip-pathno tienen equivalente; los bordes degradados y los cortes angulares se convierten en formas completas - Colores: se admite
rgb(), más los formatos que Chrome puede devolver, comooklch(),color(srgb …),lab()yhsl(); estos últimos se convierten a sRGB a través de un canvas, y cada canal puede diferir en 1 (redondeo de 8 bits) - La API de Plugin no puede cambiar el ancho de un marco dentro de una instancia. Un hijo único que se estira para llenar su marco padre se cambia a Fill, los hijos que se estiran para llenar el padre se ajustan mediante padding, y los marcos de Auto Layout que son Hug en los datos se cambian a Hug; en todos los demás casos, el tamaño sigue al componente principal, y
log.boxeslos enumera - Los elementos pequeños con z-index anidados pueden terminar cubiertos; el árbol de capas no puede mover un solo hijo fuera de su padre
- Las fuentes del sistema (
ui-sans-serif) se reemplazan con Inter; los anchos de caracteres difieren ligeramente font-variant-numeric: tabular-nums(cifras tabulares) no se puede activar en Figma:openTypeFeaturesde la API de Plugin es de solo lectura. Las fechas, horas y cantidades salen más estrechas que en el navegador, y el texto después de ellas se desplaza 5–8px;log.driftenumera estos casos- La rotación y los triángulos CSS solo se manejan para elementos sin hijos (marcas de verificación, triángulos de pestañas, cuadrados pequeños), que se convierten en vectores; los contenedores rotados con hijos se colocan según su cuadro delimitador, y su contenido no se rota
Informe
- Estructura: proporción de contenedores Auto Layout, recuento de componentes/variantes; qué áreas son absolutas (superposiciones, contenido a mitad de desplazamiento)
- Resultados de comparación: desviación de texto, las pantallas con mayor ratio de diferencia y puntos conocidos que no se pueden reproducir. Lee el ratio de diferencia en contexto: los degradados o
mask-imagede mapa de bits elevan el ratio, así que explica la causa; cuandostats.jsonadvierte que los iconos están vacíos, permite la fuente del icono y vuelve a capturar primero. Cuando una pantalla completa casi no tiene color, primero verifica si elstatdevuelto por__alBuilddetectó algún color (troubleshooting.md) - Las capturas de referencia van solo en las pantallas representativas; el resto permanece en la carpeta de salida local
- Con una biblioteca vinculada, escribe esta parte según la sección "Informe" de figma-library-binding; sin una biblioteca, los colores y tamaños de fuente son valores codificados
- Las pantallas se reproducen a partir de datos simulados; qué áreas se rellenaron con capturas en vivo y qué texto se cambió en los mocks
- Qué fuente se sustituyó cuando Figma no tiene la fuente del producto
- Escala: una línea en el formato de scale-guard.md