/ Diretório / Playground / design-dna
● Comunidade zanwei ⚡ Instantâneo

design-dna

por zanwei · zanwei/design-dna

Extraia um Design DNA quantificado de qualquer UI de referência — tokens, estilo qualitativo, efeitos visuais — depois gere componentes que o correspondam.

design-dna recebe imagens, screenshots ou URLs ao vivo como referências e emite um JSON de Design DNA estruturado: tokens de cor, escala tipográfica, espaçamento, descritores de estilo qualitativos e parâmetros de efeitos visuais. Alimente o DNA de volta ao Claude ao gerar componentes e a saída fica on-brand em vez de Tailwind genérico.

Por que usar

Principais recursos

Demo ao vivo

Como fica na prática

pronto

Instalação

Repositório do autor · Documentação oficial de Skills do Claude

Casos de uso

Usos do mundo real: design-dna

Construir um componente que corresponda a um screenshot que você admira

👤 Devs sem designer, construindo UIs polidas ⏱ ~25 min intermediate

Quando usar: Você vê um screenshot de UI incrível no Twitter e quer capturar seu estilo.

Fluxo
  1. Extrair o DNA
    Use design-dna. Extract DNA from /screens/inspiration.png. Save as dna.json.✓ Copiado
    → JSON com tokens + estilo + efeitos
  2. Gerar o componente
    Using dna.json, generate a React Card component. Match the radii, shadow, gradient parameters.✓ Copiado
    → TSX com estética correspondente
  3. Comparar visualmente
    Render side-by-side; tweak any drift in shadow strength.✓ Copiado
    → Correspondência visual dentro da tolerância

Resultado: Componente on-brand sem copiar código do original.

Armadilhas
  • DNA perde efeitos sutis (textura grain) — Passe --high-fidelity para extração mais lenta mas mais rica
Combine com: filesystem

Gerar novos componentes que correspondam ao design de um produto existente

👤 Devs adicionando features a um produto com design definido ⏱ ~30 min intermediate

Quando usar: Você está adicionando uma tela a um app existente e quer que ela pareça nativa.

Fluxo
  1. DNA da URL ao vivo
    Use design-dna. Extract DNA from https://app.example.com/dashboard (logged-in screenshot).✓ Copiado
    → DNA reflete o produto real
  2. Auditar a diferença de tokens
    Compare DNA to our existing tailwind.config — flag drift.✓ Copiado
    → Lista de deriva (ex., 'shadow-md inconsistente entre páginas')
  3. Gerar nova tela
    Generate the new 'Settings' screen using our reconciled DNA.✓ Copiado
    → Tela indistinguível do resto do app

Resultado: Produto coeso, mesmo adicionando telas meses depois.

Armadilhas
  • URL ao vivo fica atrás de autenticação — DNA da landing page pública engana — Use screenshot autenticado, não a página de marketing

Criar um design system a partir de referências

👤 Fundadores solo / times pequenos sem designer ⏱ ~60 min advanced

Quando usar: Você está começando um app e quer um design system coerente rapidamente.

Fluxo
  1. Escolher 3 referências
    Use design-dna. Extract DNA from 3 screenshots I admire (editorial, app, marketing).✓ Copiado
    → 3 objetos de DNA separados
  2. Sintetizar
    Synthesize a single DNA emphasizing the editorial type scale and the app's spacing.✓ Copiado
    → DNA mesclado
  3. Emitir um sistema inicial
    Generate tailwind.config, CSS vars, and a Button + Card + Input set using the merged DNA.✓ Copiado
    → Design system inicial no repositório

Resultado: Uma baseline coesa para iterar em vez de começar do Tailwind padrão.

Armadilhas
  • Sintetizar estéticas muito diferentes resulta em caos — Escolha referências que compartilhem uma 'família' — variações dentro de um estilo, não opostos

Combinações

Combine com outros MCPs para 10× de alavancagem

design-dna-skill + filesystem

Persistir DNA + componentes gerados no repositório

Save design.dna.json under /design/ and check in; treat it as design source-of-truth.✓ Copiado
design-dna-skill + frontend-slides-skill

Gerar decks de slides que correspondam à estética do seu produto

Use design-dna to capture our brand; pass to frontend-slides-skill for matching deck templates.✓ Copiado

Ferramentas

O que este MCP expõe

FerramentaEntradasQuando chamarCusto
extract_dna image_path ou url, fidelity? Primeiro passo a partir de qualquer referência Tokens de LLM de visão
synthesize_dna dna[] Combinando múltiplas referências Tokens de LLM
generate_component dna, component_spec Geração de componente on-brand Tokens de LLM
diff_dna dna_a, dna_b Auditar deriva entre referência e produto atual 0

Custo e limites

O que custa rodar

Cota de API
Depende do LLM de visão
Tokens por chamada
Extração ~3000–8000 tokens (entrada de imagem + saída JSON)
Monetário
Gratuito; pague ao provedor de LLM
Dica
Faça cache do DNA por projeto; só re-extraia em uma atualização real de marca

Segurança

Permissões, segredos, alcance

Escopos mínimos: filesystem-read (imagens) HTTPS de saída (refs de URL)
Armazenamento de credenciais: Nenhuma (auth do LLM de visão via variável de ambiente)
Saída de dados: Provedor de LLM de visão; fetcher de URL (se usado)

Solução de problemas

Erros comuns e correções

Extração perde gradientes

Use --fidelity high; o padrão pula gradientes sutis para economizar tokens

Tokens do DNA diferem entre execuções

Modelos de visão são estocásticos — defina seed se suportado; ou extraia duas vezes e pegue os valores medianos

Código gerado usa inline styles em vez de tokens de design

Passe --token-mode strict; a skill recusará inlinear valores que existem como tokens

Extração de URL ao vivo em branco

Site requer JS; use um screenshot totalmente renderizado em vez de fetch de URL

Alternativas

design-dna vs. outros

AlternativaQuando usarTroca
design-extract (Manavarya09)Você quer exportação completa de tokens de design incluindo DTCG + emissores multiplataformaMais pesado; pipeline completo de design system vs DNA leve
Curação manual de guia de estiloVocê tem um designer e uma biblioteca de padrõesMais lento; mais autoritativo

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills