Code Connect do Figma conecta um componente a React, SwiftUI, Compose e Vue

- Leitura
- 7 min
- Fontes
- 1
Um mesmo componente de design pode apontar para implementações em React, SwiftUI, Jetpack Compose e Vue ao mesmo tempo, e isso reabre a conversa sobre quem decide nome de variante e estado.
A documentação do Code Connect descreve um recurso que conecta um componente de design a múltiplas implementações de código ao mesmo tempo: um mesmo componente pode apontar para React↳React37 conteúdos7 erros com React moderno que só aparecem em produção; e como evitarDev (Back & Front) · abr 2026React Native 0.76: o futuro do desenvolvimento mobileDev (Back & Front) · out 2024Simplificando componentes com React HooksDev (Back & Front) · mar 2019Ver tudo em Dev (Back & Front) →, SwiftUI, Jetpack Compose e Vue simultaneamente, e isso reabre a conversa sobre quem decide nome de variante e estado.
O componente de verdade dentro do Figma
Por padrão, o Dev Mode do Figma↳Figma3 conteúdosFigma Dev Mode funciona mesmo? Testando na práticaDev (Back & Front) · mar 2025Claude Design: nova aposta da Anthropic contra Figma e MicrosoftProduto & UX · abr 2026A importância do HTML e CSS para quem trabalha com UI Design e Design SystemProduto & UX · dez 2024Ver tudo em Produto & UX → ainda gera código a partir do desenho para componentes sem conexão: CSS ou snippets genéricos, sem relação direta com o que existe no repositório. Para quem configura o Code Connect, essa lógica muda. Segundo a documentação oficial do recurso, ele cria uma ligação explícita entre o componente publicado na biblioteca do Figma e o componente real que vive no código, o que, segundo a documentação, melhora a capacidade do servidor MCP↳MCP7 conteúdosArquitetura de Sistemas Cognitivos: Integração de RAG, MCP e LLMs no Ecossistema .NETDev (Back & Front) · abr 2026MCP: O que é e por que você vai ouvir falar disso em breve?AI · jul 2025Agentes de IA com LLMs de Código Aberto: Integração Prática com o Model Context Protocol (MCP)AI · ago 2025Ver tudo em AI → do Figma de guiar agentes de IA com detalhes de implementação mais precisos, dando a eles "referências diretas ao seu código de verdade".
Na prática, isso significa que, para componentes conectados, ao clicar num botão desenhado no Figma, quem está em Dev Mode não vê mais um palpite de como aquele botão deveria ser em código. Vê o snippet do componente de produção, com as props que o time de engenharia realmente usa. Componentes ainda não conectados continuam mostrando o snippet genérico padrão do Dev Mode. É uma mudança pequena na interface e grande na governança: o design para de ser a fonte da verdade sozinho para quem adota o recurso.
Duas portas de entrada, um mesmo destino
A Figma oferece duas formas de criar essas conexões, e elas não competem entre si. Code Connect UI roda inteiro dentro do Figma: é possível autorizar acesso a um repositório GitHub e apontar componentes diretamente pela interface, ou mapear manualmente o caminho do arquivo e o nome do componente, sem GitHub nenhum. É a opção mais rápida e a mais indicada para times mistos de design e engenharia que querem algo colaborativo sem mexer em terminal.
Code Connect CLI roda localmente, no próprio repositório, e publica as conexões para o Figma de lá. Em vez de só apontar um caminho, ela usa arquivos de template para mapear propriedades do Figma às propriedades reais da API do componente em produção, o que gera exemplos de código dinâmicos e precisos. A documentação é direta sobre o público de cada ferramenta:
Code Connect UI é melhor para times de design e engenharia que querem uma configuração acessível e colaborativa; Code Connect CLI é melhor para desenvolvedores que querem precisão e flexibilidade.
Figma Developers, documentação do Code ConnectCode Connect UI: Best for design and engineering teams who want an accessible, collaborative setup. Code Connect CLI: Best for developers who want precision and flexibility in how design and code are connected.
As duas alimentam a mesma estrutura: conexões feitas pela CLI aparecem na UI, mas só podem ser editadas de volta na CLI.
Um componente, várias stacks ao mesmo tempo
O ponto que muda o jogo para equipes com produto multiplataforma é o suporte a conexões um-para-muitos. O Code Connect UI permite mapear um único componente de design para várias implementações de código, em linguagens ou frameworks diferentes. O exemplo que a própria documentação usa é direto: um componente Button pode ter conexões simultâneas para React, SwiftUI, Jetpack Compose e Vue.
Cada conexão é independente. Isso quer dizer que o caminho do arquivo, o nome do componente e as instruções customizadas podem ser diferentes para cada framework, mesmo partindo do mesmo desenho no Figma. Um design system que hoje serve web e mobile nativo deixa de precisar de documentação paralela explicando "isso aqui no React é assim, no SwiftUI é assado": a explicação mora dentro do próprio arquivo de design, por framework.
Revisar no Dev Mode. Revise a saída do Code Connect CLI com seus desenvolvedores e designers para garantir que os exemplos de componente sejam úteis e representem com precisão seus componentes de produção.
No original: Review in Dev Mode. Review the Code Connect CLI output with your developers and designers to ensure the component examples are useful and accurately represent your production components.
Para quem decide arquitetura de design system, isso reduz uma dor real: a divergência silenciosa entre a versão web e a versão nativa de um mesmo componente, que só aparecia quando alguém comparava os dois produtos lado a lado.
A ponte com agentes de IA via MCP
As conexões criadas por qualquer um dos dois caminhos alimentam o servidor MCP do Figma, que expõe esse contexto para ferramentas e editores habilitados para IA. Quando um agente de IA recebe a tarefa de implementar uma tela, ele passa a enxergar não só o desenho, mas o caminho do componente, o nome usado em produção e instruções customizadas deixadas pelo time.
Isso tem um efeito prático: o Code Connect UI inclui prévias de código geradas por IA com base nos arquivos de origem conectados, visíveis direto no Dev Mode, para quem quiser entender a implementação antes mesmo do handoff formal. A documentação faz uma ressalva importante: essas prévias são geradas em um contexto diferente do que o agente de IA usa numa conversa real, então o código final pode variar um pouco do que aparece na prévia.
Já o Code Connect CLI vai além da prévia: ele substitui o snippet autogerado do Dev Mode por exemplos reais, definidos pelo próprio design system, mapeando propriedades do Figma para a API do componente de produção. Só componentes conectados pela CLI mostram esse snippet dentro do painel de inspeção; os conectados só pela UI mostram caminho e nome, com prévia de IA à parte.
Quem decide nome de variante agora?
Aqui mora o ângulo que importa para quem trabalha na fronteira entre design e desenvolvimento. Antes do Code Connect, a nomenclatura de variante, estado e propriedade podia divergir entre Figma e código sem que ninguém notasse até o dia do handoff. Com o componente real aparecendo dentro do arquivo de design, essa divergência fica visível para qualquer pessoa que abra o Dev Mode, não só para quem lê o pull request.
Isso desloca uma decisão que antes era implicitamente do design (como nomear "Primary", "Hover", "Disabled") para uma negociação explícita com quem mantém o componente em produção. Faz sentido: se a prop real no código se chama variant="danger" e o Figma chama a mesma variante de "Destrutivo", o mapeamento do Code Connect precisa decidir qual nome prevalece na documentação viva que chega ao agente de IA e ao desenvolvedor júnior.
Na prática, times que adotarem Code Connect CLI com arquivos de template vão precisar de um ritual de revisão que hoje muitos design systems não têm: alguém do design e alguém da engenharia revisando junto, periodicamente, se o mapeamento de propriedades ainda reflete o componente de produção. A própria documentação recomenda esse passo:
Revisar no Dev Mode: revise a saída do Code Connect CLI com seus desenvolvedores e designers para garantir que os exemplos de componente sejam úteis e representem com precisão seus componentes de produção.
Figma Developers, documentação do Code ConnectReview in Dev Mode. Review the Code Connect CLI output with your developers and designers to ensure the component examples are useful and accurately represent your production components.
Sem esse ritual, o Code Connect vira uma fonte de verdade desatualizada mais rápido do que a documentação em wiki que ele deveria substituir.
O ponto que a documentação não cobre: acessibilidade
Uma lacuna que salta aos olhos para quem pensa em acessibilidade como parte da definição de pronto: a documentação do Code Connect fala de caminho de arquivo, nome de componente, instruções customizadas e mapeamento de propriedades visuais, mas não cita nada sobre atributos de acessibilidade, como aria-label, role ou estados de foco mapeados entre design e código.
Isso não é um defeito do recurso, é um limite claro do escopo atual. Se um agente de IA vai gerar código a partir dessas conexões, cabe ao time que escreve os arquivos de template garantir que a implementação de produção referenciada já tenha a camada de acessibilidade correta, porque o Code Connect vai reproduzir fielmente o que estiver lá, bom ou ruim. O recurso espelha a qualidade do componente de origem, não a corrige.
Quando não vale o esforço
Code Connect UI e CLI pressupõem um design system já publicado como biblioteca, com componentes de produção estáveis o suficiente para mapear. Para equipes pequenas, sem design system formalizado, ou em fase de protótipo ainda não codificado, configurar essas conexões é trabalho antecipado sem retorno: não há componente de produção para apontar, e o Dev Mode continuará gerando snippets genéricos de qualquer forma.
Também vale notar a limitação de plano: contas Professional só sustentam uma biblioteca e um framework ativos por vez, e trocar de framework ativo desativa as conexões anteriores sem apagá-las. A documentação não detalha o comportamento de múltiplas bibliotecas e frameworks ativos simultaneamente para os demais planos (Education, Organization, Government e Enterprise), além de registrar que o Figma for Government suporta apenas o Code Connect CLI, sem a opção de UI.
Highlights
- Code Connect mapeia um componente Figma para implementações em React, React Native, SwiftUI e Jetpack Compose ao mesmo tempo
- Documentação do Code Connect não cobre acessibilidade; recurso espelha a qualidade do componente de origem
- Design systems multiplataforma só funcionam em planos Organization, Government e Enterprise com múltiplas conexões ativas
- Code Connect CLI substitui snippet genérico por exemplos reais mapeados da API do componente de produção
- Divergência silenciosa entre versão web e nativa de componentes fica visível para qualquer um no Dev Mode
Este artigo foi escrito por Yara Uchôa, colunista de UX e product design. Conteúdo produzido por agente de IA da redação iMasters, sob revisão editorial humana. Saiba como produzimos no expediente.
O design de produto precisa parar de produzir informação e começar a desenhar decisões
Entre pesquisas, resumos e decks gerados por IA, sobra dado e falta julgamento. A pauta que a designer Patrizia Bertini levanta é sobre o que isso exige de quem desenha fluxos de decisão.














