# How do you check text contrast in AI-generated pages?

Updated 2026-11-21 · https://briefatto.com/guides/check-contrast-in-ai-generated-pages/

`board check` renders each piece and fails text below WCAG contrast, together with text that is clipped, too small where it is seen, or in a font that never loaded. It sets exit status 1 on a failure, so the agent fixes the piece before handing it over.

## Run it

```sh
npx briefatto-board check --floor-only post.html
```

On a project with a frozen DESIGN.md, run `npx briefatto-board check . "outputs/*.html"`. The block in AGENTS.md and CLAUDE.md tells the agent to run it on every piece before handing it over.

## Contrast on the rendered page

Contrast depends on the colour each piece actually paints, after every style, variable and override has applied. `board check` measures the rendered piece, so the result is the contrast your reader sees.

## Audit the current site

Run `npx briefatto-board adopt . --check` to put your existing pages through the same floor before freezing their look. The agent shows the findings and proposed fixes and waits for your yes.

## Questions and answers

### Which contrast standard does it use?

WCAG. A piece with text below WCAG contrast fails the check.

### What else does the same run check?

Clipped, off-canvas, overlapping and too-small text, fonts that never loaded, and the anti-patterns found by the Impeccable detector.

### Is Briefatto Board free?

Yes. It is open source under the Apache-2.0 licence and installs with `npx briefatto-board install`.

## Try it

```
npx briefatto-board install
```

Briefatto Board is free and open source under Apache-2.0: https://github.com/Briefatto/briefatto-board

## Related guides

- [How do you find clipped, overflowing or overlapping text in generated pages?](https://briefatto.com/guides/find-clipped-or-overlapping-text/)
- [Why your AI-made UI looks off, and how to check it](https://briefatto.com/guides/why-your-ai-ui-looks-off/)
- [How do you catch a font that is named but never loaded?](https://briefatto.com/guides/detect-a-font-that-never-loaded/)
- [Design checks as scripts instead of prompts: how board check works](https://briefatto.com/guides/deterministic-design-checks-vs-prompts/)

## Sources

- https://github.com/Briefatto/briefatto-board/blob/main/README.md
- https://github.com/Briefatto/briefatto-board/blob/main/src/board/cli.ts
- https://github.com/Briefatto/briefatto-board/blob/main/src/board/formats.ts
- https://github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
- https://github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
- https://github.com/Briefatto/briefatto-board/blob/main/LICENSE
