Landing QA
Catch the broken things before the owner does. Scripts find the wiring faults; the slices make a person look at every part of the page at both widths.
Inputs
- The site folder and the page file(s).
gates.jsonfor this round (start fromtemplates/gates.json): required counts, banned strings, stylesheets, classes added this round.- The facts file and the clicked promise, for the copy and first-screen checks.
Steps
- Screenshots and runtime checks.
python3 scripts/shot.py <site> index.html <out> --overflow. It reports scrollWidth, console errors, failed requests and blank images per width, and saves full pages and slices. - Wiring gate.
python3 scripts/gates.py <site>/index.html gates.json. Anchors, local files, one H1, viewport, counts (every CTA wired to the offer), banned strings, class collisions. - Copy, design and first screen. Run
../landing-copy/scripts/copy_lint.py,../landing-design/scripts/design_lint.pyand../first-screen-check/scripts/first_screen.py. - Read every slice, 390 first, with
references/qa-checklist.mdopen. - Fix and rerun until all green. A fix that touches another block means the whole set runs again.
- Report the outputs, the slices read, and the placeholders still owed.
Gates
shot.pyexits 0 at both widths.gates.pyexits 0.- copy_lint, design_lint and first_screen green.
- Every slice read; the by-eye list in
references/qa-checklist.mdticked.
Output
index.html 1440px scrollWidth 1440 OK errors 0 blank images 0 PASS
index.html 390px scrollWidth 390 OK errors 0 blank images 0 PASS
index.html 1440px: 3 slices, read every one
index.html 390px: 2 slices, read every one
shot: all green
gates: all green (1 anchors, 2 local files, 2 counts, 4 zero rules)
Example outputs: examples/northwind-roasters/out/shot.txt, examples/northwind-roasters/out/gates.txt,
config examples/northwind-roasters/gates.json.
Failure modes
| Trap | What it looks like | Instead |
|---|---|---|
| Green scripts, broken look | an empty grid cell nobody saw | read every slice at both widths |
| Overflow at 390 only | the page scrolls sideways on phones | --overflow lists the element; fix its width or min-width |
| CTA rewired by an edit | one button now points at #plans, which no longer exists | counts in gates.json pins every CTA |
| Class collision | a new block styled by an old stylesheet's rule | list new classes in classes; prefix per block |
| Blank lazy images | the full-page screenshot has a white hero | no lazy loading above the fold; the script scrolls but cannot fix it |
| Leftover strings | the reference's brand name in alt text | zero in gates.json lists it |
| Gates run on the wrong file | the build wrote page-v3.html, gates checked index.html | one path per round, the same in the build script and the gates |