Briefatto LabBriefatto Lab

Questions

How do you know if text on a social card is too small?

Check the size at which the card is seen, not the size of the file: board check scales its 11 px displayed-text minimum to the canvas width. A 1080x1080 post is seen 390 CSS pixels wide in the built-in formats, so its type has to be drawn far larger than it looks in the file.

Updated Markdown version

Briefatto BoardFree and open source, Apache-2.0

Blind-tested against Impeccable, Taste Skill and Hallmark

Automated tests, green CI

Claude Code, Codex, Cursor, Copilot, Gemini CLI, Windsurf and any agent that reads AGENTS.md

Seen width, not canvas width

A square post is drawn at 1080x1080 and shown in a feed at phone width. Each format in Briefatto Board carries a seenWidth, and the floor scales the 11 px minimum by the canvas width over that seen width. The built-in post, story, og and link formats are seen at 390 wide; the hero at 1440.

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

Check a card

shell
npx briefatto-board check --floor-only post.html
npx briefatto-board check --floor-only launch-og.html

For your own canvases, declare them in formats.json with their size and seenWidth, for example a README header of 1280 by 360 seen at 900 wide.

Questions and answers

Why does a label that looks fine in the file fail?

Because the file is shrunk when it is shown. The check measures the text at the width it is seen.

Does it check og:image cards?

Yes. Name the file og.html or something-og.html, and it is checked as a 1200x630 card seen 390 wide.

Is Briefatto Board free?

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

One guide. Every agent.

Briefatto Board is free and open source under Apache-2.0. One command adds the skill and the pointer your agent reads.

npx briefatto-board install

Sources

  1. github.com/Briefatto/briefatto-board/blob/main/README.md
  2. github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
  3. github.com/Briefatto/briefatto-board/blob/main/src/board/formats.ts
  4. github.com/Briefatto/briefatto-board/blob/main/src/board/cli.ts
  5. github.com/Briefatto/briefatto-board/blob/main/LICENSE