¿Qué hace visual-qa?
El JSX válido no es evidencia de buen diseño. Nunca reportes el trabajo de UI como terminado sin haberlo inspeccionado.
Núcleo
Ejecuta el sitio web localmente.
Inspecciona:
375px
390px
768px
1440px
1920px
Captura capturas de pantalla.
Revisa cada captura en busca de:
- diseño roto
- jerarquía débil
- espacio en blanco excesivo
- espacio en blanco insuficiente
- ajuste de línea feo
- recorte de imagen pobre
- márgenes inconsistentes
- tipografía sobredimensionada
- tipografía minúscula
- prominencia de CTA débil
- problemas de alineación
- patrones genéricos de diseño IA
Corrige los problemas detectados.
Repite hasta que no queden problemas visuales importantes.
Cómo ejecutarlo
Inicia el servidor de desarrollo, luego:
QA_ROUTES=/,/services,/doctors,/contact node scripts/qa-screenshots.mjs
La salida se guarda en qa/<ruta>/<ancho>.png, a página completa, un archivo por punto de interrupción.
El script también reporta desbordamiento horizontal y errores de consola por punto de interrupción:
ambos son fallos automáticos.
Puntos de interrupción capturados: 375×812, 390×844, 430×932, 768×1024, 1440×900, 1920×1080.
Configuración inicial:
npm i -D playwright && npx playwright install chromium
Para inspecciones interactivas en lugar de un barrido completo, las herramientas de navegador en el editor son más rápidas: abre la página, redimensiona, lee el árbol de accesibilidad, revisa la consola.
Lectura de una captura de pantalla
Ve punto de interrupción por punto de interrupción. Para cada uno, responde:
- ¿Se desborda algo horizontalmente?
- ¿Hay un punto focal obvio o el ojo divaga?
- ¿Los encabezados se envuelven formando un huérfano feo o una última línea de una sola palabra?
- ¿Los márgenes entre secciones son consistentes donde deberían serlo, y deliberadamente diferentes donde deberían serlo?
- ¿Las imágenes están recortadas a través de una cara, un plato o una cama?
- ¿El CTA principal es el elemento más prominente en su pantalla?
- En móvil: ¿el CTA fijo es visible, accesible con el pulgar y no cubre contenido?
- ¿Algo parece una página de IA predeterminada — degradado, cuadrícula de iconos, insignias de pastilla, manchas borrosas?
Verificaciones específicas para móvil
Los visitantes de negocios locales llegan desde Instagram, Google Maps, TikTok, anuncios y enlaces de mensajería. El móvil es la superficie principal, no un complemento.
- sin desplazamiento horizontal a 375;
- texto del héroe no sobredimensionado — no debe ocupar toda la primera pantalla;
- objetivos táctiles lo suficientemente grandes, nada diminuto;
- navegación accesible y cerrable;
- imágenes recortadas para retrato, no comprimidas desde un recorte de escritorio apaisado;
- CTA fijo presente y refinado.
Disciplina de bucle
- Corrige los hallazgos, luego vuelve a capturar. No corrijas a ciegas.
- Detente cuando un barrido completo no produzca hallazgos importantes, no cuando la lista se vuelva aburrida.
- Si el mismo hallazgo vuelve después de una corrección, el problema está en el bloque, no en la página — corrígelo en la biblioteca de bloques.
- Informa honestamente: si un punto de interrupción aún tiene un problema abierto, dilo.