O que Code to Figma faz?
Execute o projeto, extraia o DOM em uma árvore de layout no navegador e recrie-o no Figma como Auto Layout e componentes editáveis.
Para front-ends web. Os limites de componentes têm adaptadores para Vue 3 e React (React 18 e 19 testados, incluindo Server Components do Next.js App Router; 16 e 17 têm a mesma estrutura de fiber, mas não foram testados). Outros frameworks recebem apenas detecção de nós repetidos. Aplicativos nativos e telas desenhadas inteiramente em Canvas/WebGL estão fora do escopo; use o arquivo de design ou wireframes.
| Arquivo | Conteúdo |
|---|---|
| web-capture.md | O processo completo; leia antes de começar |
| screen-structure.md | Regras de estrutura que a saída deve atender |
| scale-guard.md | Limites e condições de parada para o orçamento de chamadas MCP e memória de arquivo; leia antes de começar |
| troubleshooting.md | Tabela de consulta de armadilhas; verifique quando os resultados estiverem errados |
| examples/ | Modelos de configuração de captura para quatro tipos de projeto: mock embutido, fixture Playwright, dev Nuxt, interceptando a API do backend |
| evals/trials.json | Casos de regressão e linhas de base; execute todos novamente após alterar as ferramentas |
Etapas
- Confirme as entradas: o projeto e como executá-lo, quais telas, viewport e tipo de altura de cada tela, o arquivo Figma de destino e o sistema de design a ser vinculado. O usuário decide o tópico e o escopo; não os escolha você. Assim que tiver o link do Figma, execute
create_sessionmais umuse_figmasomente leitura para confirmar que a conta com a qual o MCP está autenticado pode ler e escrever no arquivo (se não conseguir abrir o arquivo, usewhoamipara explicar qual conta é e com quem compartilhar o arquivo). Em seguida, estime quantas chamadas esse trabalho precisa de acordo com scale-guard.md "Orçamento de chamadas MCP"; se o orçamento não for suficiente, informe primeiro - Inicie o projeto, escreva a configuração, capture: execute
al-capture.cjs, seguindo web-capture.md - Construa primeiro uma tela representativa por dispositivo, compare-a com a captura de tela do navegador e faça o lote somente quando corresponder
- Compare cada tela após o lote: execute
al-diff.py; também capture a tela e verifique a seção Componentes - Audite: execute
audit-screens.js
Concluído quando: cada tela tem uma reconstrução, a largura do frame raiz de cada tela é igual ao viewport e a tela representativa de cada dispositivo tem uma camada de captura de tela de referência; issues está vazio, ou cada entrada é relatada com sua causa; a seção Componentes foi verificada em uma captura de tela.
Regras rígidas para escrever no Figma
A memória de um arquivo Figma pode disparar além do limite em um instante, mesmo quando o uso estático é baixo, e um arquivo que explode nem sempre pode ser recuperado (scale-guard.md "Incidente"). Siga estas em todos os projetos:
- Antes de escrever em um arquivo existente, peça ao usuário para salvar uma versão, inclusive antes de deletar ou reconstruir telas que você construiu anteriormente. Não comece até que o usuário responda que está salvo. Quando a página de destino não tiver nada além do que você mesmo construiu (arquivo novo, página em branco), você pode pular isso; informe isso no relatório
- Envie uma tela por vez: carregue as imagens e o SVG de dados desta tela, construa-a, confirme que os frames temporários
ALDATA-eALIMG-foram deletados, depois faça a próxima. Não carregue o lote inteiro primeiro - Se o usuário relatar um aviso vermelho ou modo de recuperação, pare imediatamente. Não execute nem mesmo um
use_figmasomente leitura até que o usuário confirme que o arquivo está bem - Pare quando o limite de chamadas for atingido: se qualquer ferramenta Figma retornar "limite de chamadas da ferramenta MCP Figma atingido", não tente novamente e não mude de ferramenta para contornar. Liste as telas concluídas e os IDs de nós dos frames temporários ainda na tela
Limitações conhecidas
- Os limites de componentes têm adaptadores para Vue 3 e React; ambos exigem modo de desenvolvimento (builds de produção não têm nomes de componentes, e
stats.jsonemitirá um aviso). Svelte, Angular e outros frameworks recebem apenas detecção de nós repetidos; para oferecer suporte a um, adicione uma entrada emADAPTERSnoal-extract.js - Regras de nomenclatura de componentes React: um nó DOM conta como limite apenas quando é o único nó raiz do componente, e o nome é obtido do componente mais externo. Componentes que apenas passam filhos (Provider, Tooltip, ErrorBoundary), componentes de estilo styled-components/emotion e componentes internos do roteador e do framework não contam. Nomes de Server Components Next.js exigem uma build de desenvolvimento React 19 (Next 15 ou superior); com React 18, apenas componentes cliente são capturados
- React: o projeto de demonstração Vite + Radix + Tailwind 4 tem uma linha de base de reconstrução Figma (quatro telas, 0,02–0,12% de diferença do navegador). O projeto Next.js App Router é verificado apenas através de captura e empacotamento
- Ícones que usam um SVG como
mask-imagee não têm filhos (ex.: frappe-ui, classeslucide-*do UnoCSS) são convertidos em vetores e coloridos com a cor de fundo. Outros usos demask-image(fades gradientes, máscaras bitmap) eclip-pathnão têm equivalente; bordas desbotadas e cortes angulares tornam-se formas completas - Cores:
rgb()é suportado, além dos formatos que o Chrome pode retornar, comooklch(),color(srgb …),lab()ehsl(); estes últimos são convertidos para sRGB através de um canvas, e cada canal pode diferir em 1 (arredondamento de 8 bits) - A API do Plugin não pode alterar a largura de um frame dentro de uma instância. Um filho único que se estica para preencher o frame pai é alterado para Fill, filhos que se esticam para preencher o pai são ajustados através de padding, e frames Auto Layout que estão em Hug nos dados são alterados para Hug; em todos os outros casos, o tamanho segue o componente principal, e
log.boxesos lista - Elementos pequenos com z-index aninhado podem acabar cobertos; a árvore de camadas não pode mover um único filho para fora de seu pai
- Fontes do sistema (
ui-sans-serif) são substituídas por Inter; as larguras dos caracteres diferem ligeiramente font-variant-numeric: tabular-nums(figuras tabulares) não pode ser ativado no Figma:openTypeFeaturesda API do Plugin é somente leitura. Datas, horas e valores saem mais estreitos do que no navegador, e o texto após eles desloca 5–8px;log.driftlista estes- Rotação e triângulos CSS são tratados apenas para elementos sem filhos (marcas de seleção, triângulos de abas, pequenos quadrados), que são convertidos em vetores; containers rotacionados com filhos são dispostos por sua caixa delimitadora, e seu conteúdo não é rotacionado
Relatório
- Estrutura: proporção de containers Auto Layout, contagem de componentes/variantes; quais áreas são absolutas (overlays, conteúdo em meio ao scroll)
- Resultados da comparação: desvio de texto, as telas com maior taxa de diferença e pontos conhecidos que não podem ser reproduzidos. Leia a taxa de diferença no contexto: gradientes ou
mask-imagebitmap aumentam a taxa, então explique a causa; quandostats.jsonavisar que ícones estão vazios, permita a fonte do ícone e recapture primeiro. Quando uma tela inteira quase não tem cor, verifique primeiro se ostatretornado por__alBuildcapturou alguma cor (troubleshooting.md) - Capturas de tela de referência vão apenas nas telas representativas; as demais permanecem na pasta de saída local
- Com uma biblioteca vinculada, escreva esta parte conforme a seção "Relatório" do figma-library-binding; sem biblioteca, cores e tamanhos de fonte são valores codificados
- As telas são reproduzidas a partir de dados mock; quais áreas foram preenchidas com capturas de tela ao vivo e qual cópia foi alterada nos mocks
- Qual fonte foi substituída quando o Figma não tem a fonte do produto
- Escala: uma linha no formato scale-guard.md