O que screenshot-to-compose faz?
Reproduza um design fielmente em Compose sem estimar visualmente. A imagem de referência é o teste de aceitação, então cada número que você usa é observado (medido na imagem) ou inferido (um palpite que você declara), e a tela finalizada é comparada com a referência ao final.
Quando o design é a entrada
- Apenas capturas de tela/mockups: siga todas as fases abaixo.
- Quadros do Figma disponíveis: pule a medição (leia os valores do Figma) e mantenha o restante.
- Ainda não há design: use o skill
app-design-studioprimeiro e depois volte aqui.
Fluxo de trabalho
Trabalhe em arquivos (docs/design/), uma tela por vez após as fundações compartilhadas existirem. Não implemente nada até que todo o inventário de telas seja compreendido.
- Inspecione. Leia o repositório primeiro (arquitetura, tema, componentes compartilhados, telas existentes). Preserve o que funciona. Anote suposições.
- Inventário. Copie as referências inalteradas para
docs/design/reference/(nomes em kebab-case). EscrevaSCREEN_INVENTORY.md: cada imagem -> tela + estado, links entre telas, referências ausentes (uma tela linkada mas não mostrada), tamanho em pixels e proporção. Inclua todos os estados: carregando, vazio, erro, offline, permissão, premium. - Meça. Execute
scripts/measure_image.py shot.png --frame-dp 390 --sample x,y ...para a escala px->dp e amostras de cor (references/measuring.md). Pixels não são dp: assuma um frame de 390 dp a menos que informado o contrário,dp = px / (imageWidthPx / 390). Registre valores observados e inferidos em colunas separadas. - Sistema de design. Mapeie as cores medidas para os papéis do Material 3, escala tipográfica, formas, espaçamentos no tema. As telas usam apenas tokens de tema (sem hex, tamanhos ou raios nas telas). Defina claro e escuro; se apenas o claro existe, derive o escuro sem alterar o layout.
- Ativos (
references/assets.md). Ícones: uma família, obtidos do Iconify, convertidos comscripts/svg_to_vectordrawable.py. Arte: gere-a, nunca a recorte das capturas de tela. Texto, botões, cartões, anéis e gráficos são sempre Compose, nunca imagens. Registre origem, licença, modelo e prompt emASSET_INVENTORY.md. - Planeje. Por tela, decida antecipadamente: comportamento do botão voltar, classe de rede/offline, permissões, scroll-ou-ajuste em celulares pequenos, movimento. Escreva
SCREEN_IMPLEMENTATION_PLAN.mdcom a ordem de construção. (As regras de qualidade para estas vivem no skillandroid-compose-quality-gate.) - Implemente as fundações compartilhadas primeiro, depois as telas: composables sem estado sobre um estado de UI imutável, ViewModel com intents, um composable por arquivo, recursos de string para todo texto. Paralelize apenas módulos independentes com arquivos disjuntos. Leia
references/compose-lessons.mdantes de construir cartões, tiles ou texto apertado. - Compare (
references/verification.md). Renderize a tela (captura de emulador ou Roborazzi), coloque-a ao lado da referência com largura igual usandoscripts/compare_side_by_side.py, liste diferenças em layout, espaçamento, tipografia, cor, formas e ativos, corrija, repita. Em seguida, verifique dispositivos pequenos (360 x 526 dp), texto longo/alemão, RTL, escuro, escala de fonte 1.3. Nunca troque funcionalidade ou responsividade por correspondência de pixel. - Entregue. Mantenha referências, ativos com prompts, origens/licenças de ícones, inventários e notas de comparação atualizados. Uma tela está pronta apenas quando funciona e passa na comparação visual. Commite por tópico.
Regras que impedem as falhas comuns
- Nunca recorte imagens das capturas de tela de referência (baixa resolução, comprimidas, UI embutida).
- Nunca substitua UI nativa por uma imagem dela.
- Nunca invente um design quando a referência é ambígua: faça a inferência mais razoável, escreva-a na coluna inferida, mantenha-se próximo à referência.
- Não afirme que uma tela está pronta antes de ela ter sido executada e comparada.
- Sem segredos (chaves de API) no repositório ou docs; chaves de serviços de imagem vêm do ambiente.
Arquivos
references/measuring.md- px para dp, amostragem de cor, tabelas observado vs inferido.references/assets.md- Iconify para VectorDrawable, ordem de geração de imagem e revisão, tamanhos de exportação, outras fontes.references/compose-lessons.md- defeitos que custam tempo real: proporções de cartões irmãos, travamento por medição intrínseca, limites de largura, texto com redimensionamento automático.references/verification.md- loop de comparação entre emulador e Roborazzi e a matriz de dispositivos.scripts/measure_image.py,scripts/svg_to_vectordrawable.py,scripts/compare_side_by_side.py(Python 3 + Pillow).