Run it on a page
With no design guide yet, name the file after its format and run the floor on its own:
npx briefatto-board check --floor-only hero.htmlThe built-in formats include hero (1440x900), post (1080x1080), story (1080x1920), og (1200x630) and link (1200x628). A file such as launch-og.html is read as an og piece.
With a frozen DESIGN.md, check any piece against it: npx briefatto-board check . outputs/post.html.
What it reports
- AI-design tells found by the Impeccable detector, which Briefatto Board credits in its README.
- Legibility faults: text clipped, off the canvas, over other text or too small where it is seen.
- Fonts that never loaded, and contrast below WCAG.
- A receipt that records which checks ran, and exit status 1 when any piece fails.
Questions and answers
Does the detector need a design guide first?
No. --floor-only runs on HTML files named after a format, such as hero.html or post.html, with no frozen guide.
Can I run it in CI?
Yes. board check sets exit status 1 when any piece fails, so a CI step stops on it.
Is Briefatto Board free?
Yes. It is open source under the Apache-2.0 licence and installs with npx briefatto-board install.