# DESIGN.md with Next.js and Tailwind in Cursor

Updated 2026-11-21 · https://briefatto.com/guides/cursor-nextjs-tailwind-briefatto-board/

Adopt your running Next.js app with `npx briefatto-board adopt . --page http://localhost:3000/`, let Cursor's agent write DESIGN.md from the captures and your Tailwind theme, and freeze it. Cursor reads AGENTS.md, where Briefatto Board's block tells it to read DESIGN.md before any visual work.

## How it fits

- Cursor's [rules documentation](https://cursor.com/docs/context/rules) lists AGENTS.md as agent instructions, a plain-markdown alternative to `.cursor/rules`. Briefatto Board writes its block there.
- Cursor's [skills documentation](https://cursor.com/docs/skills) loads skills from `.claude/skills/` for compatibility, where the Briefatto Board skill installs.
- Next.js [uses](https://nextjs.org/docs/app/api-reference/cli/next) http://localhost:3000 during development by default, and `board adopt` captures the URLs you pass.
- Tailwind [theme variables](https://tailwindcss.com/docs/theme) compile to regular CSS variables, which the skill tells the agent to inspect.

## Set it up in Cursor

1. Run `next dev` and leave it running.
2. In Cursor's terminal: `npx briefatto-board install`.
3. Capture the brand: `npx briefatto-board adopt . --page http://localhost:3000/ --page http://localhost:3000/blog`.
4. Ask Cursor's agent to follow the Briefatto Board skill and write DESIGN.md from the captures.
5. Freeze it: `npx briefatto-board freeze .`.

For a static export, `next build` with `output: "export"` writes an `out` folder; adopt it with `npx briefatto-board adopt . --root out`.

## Keep Cursor's UI on the theme

- `board check` fails clipped text, small text, unloaded fonts and contrast below WCAG on every piece.
- `board check --consistency` lists colours off the frozen palette, each with its nearest frozen colour, and fonts outside the guide.
- After a brand change, freeze v2 and `board status` lists what is stale.

## Questions and answers

### Do I need a .cursor/rules file for my Tailwind theme?

No. The theme stays in Tailwind, the brand guide in DESIGN.md, and the pointer in AGENTS.md, which Cursor reads.

### Does it work with the App Router?

Yes. Board captures the rendered pages at the URLs you pass, whichever router serves them.

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

- [Cursor + Briefatto Board: on-brand UI from one DESIGN.md](https://briefatto.com/guides/cursor-briefatto-board/)
- [DESIGN.md with Next.js and Tailwind in Claude Code](https://briefatto.com/guides/claude-code-nextjs-tailwind-briefatto-board/)
- [DESIGN.md with Vite and React in OpenAI Codex](https://briefatto.com/guides/codex-vite-react-briefatto-board/)
- [How do you put a design system into Cursor rules?](https://briefatto.com/guides/cursor-rules-design-system/)

## Sources

- https://cursor.com/docs/context/rules (checked 2026-11-21)
- https://cursor.com/docs/skills (checked 2026-11-21)
- https://nextjs.org/docs/app/api-reference/cli/next (checked 2026-11-21)
- https://nextjs.org/docs/app/guides/static-exports (checked 2026-11-21)
- https://tailwindcss.com/docs/theme (checked 2026-11-21)
- 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://github.com/Briefatto/briefatto-board/blob/main/LICENSE

Briefatto Board is independent and is not affiliated with Cursor.
