O que visual-qa faz?
JSX válido não é evidência de bom design. Nunca reporte trabalho de UI como concluído sem ter olhado para ele.
Núcleo
Execute o site localmente.
Inspecione:
375px
390px
768px
1440px
1920px
Capture screenshots.
Revise cada screenshot em busca de:
- layout quebrado
- hierarquia fraca
- espaçamento excessivo
- espaçamento insuficiente
- quebra de linha feia
- corte de imagem ruim
- margens inconsistentes
- tipografia exagerada
- tipografia minúscula
- destaque fraco do CTA
- problemas de alinhamento
- padrões genéricos de design IA
Corrija os problemas detectados.
Repita até que nenhum problema visual significativo permaneça.
Como executar
Inicie o servidor de desenvolvimento e então:
QA_ROUTES=/,/services,/doctors,/contact node scripts/qa-screenshots.mjs
A saída vai para qa/<rota>/<largura>.png, em página cheia, um arquivo por breakpoint.
O script também reporta overflow horizontal e erros de console por breakpoint — ambos são falhas automáticas.
Breakpoints capturados: 375×812, 390×844, 430×932, 768×1024, 1440×900, 1920×1080.
Configuração inicial:
npm i -D playwright && npx playwright install chromium
Para análises interativas em vez de uma varredura completa, as ferramentas do navegador no editor são mais rápidas: abra a página, redimensione, leia a árvore de acessibilidade, verifique o console.
Lendo um screenshot
Vá breakpoint por breakpoint. Para cada um, responda:
- Há algo transbordando horizontalmente?
- Há um ponto focal óbvio, ou o olho vagueia?
- Os títulos quebram em uma órfã feia ou em uma última linha de uma palavra?
- As margens entre as seções são consistentes onde deveriam ser e deliberadamente diferentes onde deveriam ser?
- As imagens estão cortadas através de um rosto, um prato ou uma cama?
- O CTA principal é o elemento mais proeminente em sua tela?
- No celular: o CTA fixo está visível, acessível ao polegar e não está cobrindo conteúdo?
- Algo parece uma página de IA padrão — gradiente, grade de ícones e cartões, badges de pílula, bolhas borradas?
Verificações específicas para celular
Visitantes de negócios locais chegam do Instagram, Google Maps, TikTok, anúncios e links de mensageiros. O celular é a superfície principal, não um complemento.
- sem scroll horizontal em 375;
- texto do herói não exagerado — não deve ocupar toda a primeira tela;
- alvos de toque grandes o suficiente, nada minúsculo;
- navegação alcançável e fechável;
- imagens cortadas para retrato, não comprimidas de um corte de paisagem para desktop;
- CTA fixo presente e refinado.
Disciplina do loop
- Corrija os achados, depois recapture. Não corrija às cegas.
- Pare quando uma varredura completa não produzir nenhum achado importante, não quando a lista ficar entediante.
- Se o mesmo achado retornar após uma correção, o problema está no bloco, não na página — corrija-o na biblioteca de blocos.
- Relate honestamente: se um breakpoint ainda tiver um problema em aberto, diga-o.