# How do you catch a font that is named but never loaded?

Updated 2026-11-21 · https://briefatto.com/guides/detect-a-font-that-never-loaded/

`board check` fails any piece whose text renders in a font that never loaded, so a face named in the CSS but missing from the page is caught before handover. It also checks the font weight and style each piece actually uses.

## Why it happens

An agent writes `font-family: "Your Brand Sans"` and never adds the line that loads it. The browser quietly falls back to another face, and the page looks almost right. A rendered check sees the face that actually painted the text.

## Catch it

- `npx briefatto-board check --floor-only hero.html` fails text in a font that never loaded, with no guide needed.
- With a frozen guide, `board check . <piece.html>` also notes any font that is not in the current guide.
- The same run checks the weight and style each piece actually uses.

## Prevent it

The Briefatto Board skill has the agent put the exact font load lines under `## Typography` in DESIGN.md, from resolvable sources, so every later piece starts from lines that load.

## Questions and answers

### Does it check self-hosted fonts as well as web fonts?

Yes. It checks what renders, so a face that never loaded fails the piece however it was meant to load.

### Will it stop the handover?

Yes. `board check` sets exit status 1 when any piece fails, so the agent, a hook or CI 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`.

## 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 check text contrast in AI-generated pages?](https://briefatto.com/guides/check-contrast-in-ai-generated-pages/)
- [How do you write a good DESIGN.md that an agent can use?](https://briefatto.com/guides/how-to-write-a-good-design-md/)

## Sources

- https://github.com/Briefatto/briefatto-board/blob/main/README.md
- https://github.com/Briefatto/briefatto-board/blob/main/CHANGELOG.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/Briefatto/briefatto-board/blob/main/src/board/formats.ts
- https://github.com/Briefatto/briefatto-board/blob/main/src/board/check.ts
- https://github.com/Briefatto/briefatto-board/blob/main/LICENSE
