# Is there a free DESIGN.md template?

Updated 2026-11-21 · https://briefatto.com/guides/design-md-template/

The recorded DESIGN.md in Briefatto Board's `current-site` example, a small site called Sedge Ferry, is a free, working template: YAML front matter, then Overview, Colours, Typography, Parts and Layout. Copy the outline, let your agent fill it from your own pages with `board adopt`, and stamp it with `board freeze`.

## The outline

This is the shape of the recorded guide in the repository's `current-site` example, with the values taken out:

```markdown
---
name: <Brand>
colors:
  paper: "<hex>"
  ink: "<hex>"
  signal: "<hex>"
typography:
  heading:
    fontFamily: <family>
    fontSize: <size>
  body:
    fontFamily: <family>
    fontSize: <size>
---

# <Brand>

## Overview
## Colours
## Typography
## Parts
## Layout
```

The freeze stamp goes between the front matter and the first heading. Board writes it; you never type it.

## What goes under each heading

- **Overview.** What the brand is for and how it talks, with example copy taken from the real pages.
- **Colours.** Each colour by its job: the page ground, the reading text, the one accent and where it goes.
- **Typography.** Which parts use each face, plus the font load lines from sources that resolve.
- **Parts.** Each recurring part named by its job, then how it is built.
- **Layout.** How the arrangement recomposes for a phone, a wide screen or a square post.

Write it as a handoff from one designer to another, sufficient on its own. Leave out measured ratios and coverage percentages: freeze records the exact computed styles for you.

## Turn the template into your guide

1. Run `npx briefatto-board install`.
2. Have a site? Run `npx briefatto-board adopt .` and let your agent write each section from the captures.
3. No site yet? Put the brief in `brief.md` and go from references to three directions to a pick.
4. Run `npx briefatto-board freeze .`. It compares the colours, font families and font sizes you wrote, front matter included, with values from a fresh render and names every conflict.

## Questions and answers

### Can I copy a popular brand's DESIGN.md and use it as mine?

Use it to learn the shape. The [brand library](https://briefatto.com/guides/#brands) holds DESIGN.md files for popular brands, and a live brand site makes a good reference: `board refs . --capture <url> first.png` puts it on your reference sheet. Your own guide describes your own pages, and freeze names any written value your render contradicts.

### Does the template follow Google's design.md format?

Its front matter carries the tokens freeze reads: a YAML `colors:` block and `fontFamily` and `fontSize` fields. Freeze reads a YAML `colors:` block and `fontFamily` and `fontSize` fields, and treats a reference in braces, such as `{colors.primary}`, as a token name.

### Where are complete examples?

The repository has three: plumb, a brief for an invented open-source tool; bakery, a brief with CC0 photographs; and current-site, a small site to adopt, which ships its recorded DESIGN.md.

### Is the template free to use?

Yes. Briefatto Board and its examples are Apache-2.0 on GitHub at Briefatto/briefatto-board.

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

- [Where can I see a real DESIGN.md example?](https://briefatto.com/guides/design-md-examples/)
- [How do you write a good DESIGN.md that an agent can use?](https://briefatto.com/guides/how-to-write-a-good-design-md/)
- [How to create a DESIGN.md from your site or a new brand](https://briefatto.com/guides/how-to-create-a-design-md/)
- [What is DESIGN.md, and how do coding agents use it?](https://briefatto.com/guides/what-is-design-md/)

## Sources

- https://github.com/Briefatto/briefatto-board/blob/main/examples/current-site/recorded/DESIGN.md
- https://github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
- https://github.com/Briefatto/briefatto-board/blob/main/src/board/design-validation.ts
- https://github.com/Briefatto/briefatto-board/blob/main/README.md
- https://github.com/Briefatto/briefatto-board/blob/main/LICENSE
