Que fait visual-qa ?
Un JSX valide n'est pas une preuve de bon design. Ne déclarez jamais un travail d'interface utilisateur comme terminé sans l'avoir examiné.
Cœur
Exécutez le site web localement.
Inspectez :
375px
390px
768px
1440px
1920px
Capturez des captures d'écran.
Examinez chaque capture d'écran pour :
- mise en page cassée
- hiérarchie faible
- espace blanc excessif
- espace blanc insuffisant
- saut de ligne disgracieux
- mauvais recadrage d'image
- marges incohérentes
- typographie surdimensionnée
- typographie minuscule
- faible proéminence du CTA
- problèmes d'alignement
- schémas de conception génériques IA
Corrigez les problèmes détectés.
Répétez jusqu'à ce qu'aucun problème visuel majeur ne subsiste.
Comment l'exécuter
Démarrez le serveur de développement, puis :
QA_ROUTES=/,/services,/doctors,/contact node scripts/qa-screenshots.mjs
La sortie se trouve dans qa/<route>/<largeur>.png, plein écran, un fichier par point de rupture.
Le script signale également les débordements horizontaux et les erreurs de console par point de rupture — les deux sont des échecs automatiques.
Points de rupture capturés : 375×812, 390×844, 430×932, 768×1024, 1440×900, 1920×1080.
Configuration initiale :
npm i -D playwright && npx playwright install chromium
Pour une exploration interactive plutôt qu'un balayage complet, les outils de navigation intégrés à l'éditeur sont plus rapides : ouvrez la page, redimensionnez, lisez l'arborescence d'accessibilité, vérifiez la console.
Lecture d'une capture d'écran
Allez point de rupture par point de rupture. Pour chacun, répondez :
- Y a-t-il un élément qui déborde horizontalement ?
- Y a-t-il un point focal évident, ou l'œil vagabonde-t-il ?
- Les titres se brisent-ils en un orphelin disgracieux ou une dernière ligne d'un seul mot ?
- Les marges entre les sections sont-elles cohérentes là où elles doivent l'être, et délibérément différentes là où elles doivent l'être ?
- Les images sont-elles recadrées à travers un visage, une assiette ou un lit ?
- Le CTA principal est-il l'élément le plus proéminent dans son écran ?
- Sur mobile : le CTA collant est-il visible, accessible au pouce et ne couvre-t-il pas le contenu ?
- Y a-t-il quelque chose qui ressemble à une page IA par défaut — dégradé, grille d'icônes-cartes, badges pastilles, blobs flous ?
Vérifications spécifiques aux mobiles
Les visiteurs d'entreprise locale arrivent depuis Instagram, Google Maps, TikTok, les publicités et les liens de messagerie. Le mobile est la surface principale, pas une réflexion après coup.
- pas de défilement horizontal à 375 ;
- le texte du héros n'est pas surdimensionné — il ne doit pas manger tout le premier écran ;
- les cibles tactiles sont suffisamment grandes, rien de minuscule ;
- la navigation est accessible et fermable ;
- les images sont recadrées pour le portrait, non comprimées à partir d'un recadrage paysage de bureau ;
- le CTA collant est présent et raffiné.
Discipline de boucle
- Corrigez les résultats, puis recapturez. Ne corrigez pas à l'aveugle.
- Arrêtez-vous lorsqu'un balayage complet ne produit aucun résultat majeur, pas lorsque la liste devient ennuyeuse.
- Si le même résultat revient après une correction, le problème se trouve dans le bloc, pas dans la page — corrigez-le dans la bibliothèque de blocs.
- Rapportez honnêtement : si un point de rupture a encore un problème ouvert, dites-le.