# How do you improve Claude Code's frontend design?

Updated 2026-11-21 · https://briefatto.com/guides/improve-claude-code-frontend-design/

Start with what Claude Code already built: `npx briefatto-board adopt . --check` runs the floor on your current pages, the agent proposes fixes and waits for your yes, and the repaired look is frozen as DESIGN.md so every later session builds from it.

## Measure the pages you have

Claude Code's frontend gets fixed one finding at a time, and the findings come from the rendered page. Start the app, then capture the routes that carry the brand:

```sh
npx briefatto-board install
npx briefatto-board adopt . --check --page http://localhost:3000/ --page http://localhost:3000/pricing
```

`--check` runs the floor on each selected page: clipped text, text off the canvas or over other text, type too small where it is seen, fonts that never loaded, contrast below WCAG, and the Impeccable detector's anti-patterns. Captures are desktop and mobile by default. Static files or a build folder work too, with `--root <dir>`.

## Fix, recapture, freeze

1. Claude Code shows you the findings and the fixes it proposes, then waits for your yes.
2. It fixes the agreed issues and reruns the capture and the floor.
3. It writes DESIGN.md from the revised pages: screenshots in `.briefatto/adoption/`, computed styles in `evidence.json`, your CSS variables, Tailwind configuration and logo files.
4. `npx briefatto-board freeze . --check` stamps the guide only when the floor passes as well as the guide validation.

## Hold every new screen to the repaired look

After the freeze, the block in CLAUDE.md and AGENTS.md tells Claude Code to read DESIGN.md before any visual work and to run `board check` on every piece before handing it over. A failing piece sets exit status 1, which the agent reads as a fault to fix before hand-over, and which stops a pre-commit hook or CI run.

Add `--consistency` to `board check` on a kit format and it lists every colour off the frozen palette, each with its nearest frozen colour, plus fonts outside the guide.

## Questions and answers

### Will Claude Code redesign the whole app?

No. It proposes fixes and waits for your yes, and for feedback on one piece it edits only that piece. After a brand change, `board status` lists what needs revisiting and nothing is redrawn behind your back.

### Do I need a design file before I start?

No. `board adopt` captures the pages and Claude Code writes DESIGN.md from what it sees. You review it before it is frozen.

### Does this work with a Next.js or Vite dev server?

Yes. Pass each route's URL with `--page`, for example `http://localhost:3000/` on Next.js, and leave the server running for the freeze.

### What if I like the current look?

Skip `--check`. Run `npx briefatto-board adopt .`, let Claude Code write the guide, and freeze it with `npx briefatto-board freeze .` to keep the look exactly as it renders.

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

- [Why does every site Claude Code builds look the same?](https://briefatto.com/guides/why-claude-code-sites-look-the-same/)
- [How to make Claude Code follow your brand with DESIGN.md](https://briefatto.com/guides/how-to-use-design-md-in-claude-code/)
- [Why your AI-made UI looks off, and how to check it](https://briefatto.com/guides/why-your-ai-ui-looks-off/)
- [Can Claude Code design UI?](https://briefatto.com/guides/can-claude-code-design-ui/)
- [DESIGN.md with Next.js and Tailwind in Claude Code](https://briefatto.com/guides/claude-code-nextjs-tailwind-briefatto-board/)

## Sources

- 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/README.md
- https://github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
- https://github.com/Briefatto/briefatto-board/blob/main/src/board/check.ts
- https://nextjs.org/docs/app/api-reference/cli/next (checked 2026-11-21)
