# How do you extract a design system from an existing website?

Updated 2026-11-21 · https://briefatto.com/guides/extract-design-system-from-a-website/

Capture the site as it renders: `npx briefatto-board adopt .` records screenshots, computed styles and visible copy for each page you choose, your agent writes DESIGN.md from that evidence, and `board freeze` stamps it with the exact values.

## Choose what to capture

A design system shows up across routes and screen sizes, so capture the pages that carry it, not just the home page.

| Your site is | Run |
| --- | --- |
| Static HTML in the project | `npx briefatto-board adopt .` |
| A build in another folder | `npx briefatto-board adopt . --root dist` |
| Running on a dev server | `npx briefatto-board adopt . --page http://localhost:3000/ --page http://localhost:3000/docs` |

Captures are desktop and mobile by default. Repeat `--viewport WIDTHxHEIGHT` for other sizes. Leave a running site running for the freeze.

## What the agent reads

The capture is evidence, and your agent does the reading. The skill tells it to open each screenshot in `.briefatto/adoption/`, read `evidence.json` for computed styles, visible copy and candidate style files, and inspect the page source, CSS variables, Tailwind configuration, theme and logo files those pages use.

From that it writes DESIGN.md as a designer's handoff: layout, spacing, navigation, components and logo by role, the voice from the real copy, and how the layout recomposes on other canvases.

## Freeze turns notes into a record

`npx briefatto-board freeze .` records the exact styles of a fresh render in a generated block, checks the prose against them and names any conflicting value. The guide is stamped as v1 and archived.

When the site changes, capture again and freeze the next version. `board log` shows the history and `board diff v1 v2` shows what moved.

## Questions and answers

### Does it capture the mobile layout?

Yes. The default captures are desktop and mobile, and `--viewport` adds any other size you name.

### Can I fix problems before I extract?

Yes. `board adopt . --check` runs the floor on the selected pages; the agent shows the findings and proposed fixes and waits for your yes before it fixes, recaptures and freezes.

### Which agent writes the DESIGN.md?

The one you already use. Briefatto Board works with any coding agent that reads AGENTS.md and runs shell commands: Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf and the rest.

## 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 to create a DESIGN.md from your site or a new brand](https://briefatto.com/guides/how-to-create-a-design-md/)
- [Design docs drift from the real design: how freeze stops it](https://briefatto.com/guides/design-docs-drift-from-the-real-design/)
- [How is DESIGN.md different from a Tailwind config?](https://briefatto.com/guides/design-md-vs-tailwind-config/)
- [How do you make an AI agent's new page match your existing site?](https://briefatto.com/guides/make-new-pages-match-your-existing-site/)
- [DESIGN.md with Vite and React in OpenAI Codex](https://briefatto.com/guides/codex-vite-react-briefatto-board/)

## 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/Briefatto/briefatto-board/blob/main/CHANGELOG.md
- https://nextjs.org/docs/app/api-reference/cli/next (checked 2026-11-21)
- https://vite.dev/config/build-options (checked 2026-11-21)
