Who it is forA developer who maintains a static site and wants a script to refuse a build that contains a broken control.
The problemA broken button or a count that goes wrong can ship unnoticed when nothing checks the built page.
The outcomeA script that stops with an error when Assay flags a problem and passes when the page is clean.
What you need first
- Python 3.10+, or uv or pipx to install the tool
- A folder containing built web page output, with index.html or another page to check
- Internet access for the first run, when Chromium may be downloaded
Steps
- Run
pip install assay-uion the machine that runs the build. - Run the build step that writes the built page output to a folder.
- Add
assay <built folder> --one-lineafter the build step in your script, replacing <built folder> with the output path. (inferred, check the README) - Confirm the script stops when a known broken page is used as input, then keep the step in place.
Prompt for your agent
Add an assay check to the build script in <repo path>. After the build writes to <output folder>, run assay <output folder> --one-line and stop the script if the exit code is non-zero. Verify by running the script against a page with a known broken control and confirming it stops.
Caveat. Assay only checks built output, so it will not run your build or npm install for you, and the build step must be run first.
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer