# Why your AI-made UI looks off, and how to check it

Updated 2026-11-21 · https://briefatto.com/guides/why-your-ai-ui-looks-off/

Clipped text, text over other text, type too small where it is seen, a font that never loaded and low contrast make AI-made UI look off, and a program catches each one. `board check` finds them on the rendered page, plus the AI-design tells the Impeccable detector knows.

## What board check catches

`board check` renders each piece and fails it for clipped text, text off the canvas, text over other text, text too small where it is seen, fonts that never loaded and contrast below WCAG. It also reports anti-patterns found by the Impeccable detector.

On the Plumb example it failed a 16px label where 22px was the minimum where it is seen, and passed it once the label was raised to 26px.

## Run it

```sh
npx briefatto-board check . outputs/post.html
```

## Questions and answers

### Does it work on any HTML?

Yes. It checks any rendered HTML piece, plus the PNG and PDF exports you list for it.

### What counts as too small?

The floor scales its 11 px displayed-text minimum to the canvas width, so a label is judged at the size it is seen.

### 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

- [Design checks as scripts instead of prompts: how board check works](https://briefatto.com/guides/deterministic-design-checks-vs-prompts/)
- [Why do AI-built sites all look the same, and how do you fix it?](https://briefatto.com/guides/why-ai-built-sites-look-the-same/)
- [How to make an AI agent follow your design rules](https://briefatto.com/guides/make-an-agent-follow-your-design-rules/)
- [Claude Code ignores AGENTS.md or CLAUDE.md: what to do](https://briefatto.com/guides/claude-code-ignores-agents-md/)

## Sources

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