# DESIGN.md with Vite and React in OpenAI Codex

Updated 2026-11-21 · https://briefatto.com/guides/codex-vite-react-briefatto-board/

Start Vite's dev server and run `npx briefatto-board adopt . --page http://localhost:5173/`, or build and run `npx briefatto-board adopt . --root dist`, then let Codex write DESIGN.md and freeze it. Codex reads AGENTS.md, where Briefatto Board's block tells it to read DESIGN.md before any visual work.

## How it fits

- OpenAI's Codex documentation has a guide, [Custom instructions with AGENTS.md](https://developers.openai.com/codex/guides/agents-md). Briefatto Board writes its block to AGENTS.md.
- Vite's [guide](https://vite.dev/guide/) serves the app on http://localhost:5173 during development, and its [build options](https://vite.dev/config/build-options) give `dist` as the default output folder.
- `board adopt` captures a running site from URLs, or a build folder with an index page through `--root`.

## Set it up

```sh
npx briefatto-board install
# with the Vite dev server running:
npx briefatto-board adopt . --page http://localhost:5173/
# or, after a production build:
npx briefatto-board adopt . --root dist
```

Ask Codex to follow the Briefatto Board skill and write DESIGN.md from the captures, then run `npx briefatto-board freeze .`. You can also install the skill through skills.sh with `npx skills add Briefatto/briefatto-board`.

## What Codex gets

- **Your React app's real look,** recorded as exact styles from a fresh render.
- **A check on every piece.** `board check` fails clipped text, small text, unloaded fonts and low contrast.
- **Versions.** `board diff v1 v2` shows what changed, and `board status` lists stale pieces.

## Questions and answers

### Dev server or build folder?

Either. Pass `--page` URLs for a running dev server, or `--root dist` for a production build. With a running site, keep it running until freeze.

### Does it need my component library?

No. Board captures the rendered pages and computed styles, and the agent reads your CSS variables and theme files when it writes the guide.

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

- [OpenAI Codex + Briefatto Board: one DESIGN.md for your agent](https://briefatto.com/guides/codex-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 Next.js and Tailwind in Cursor](https://briefatto.com/guides/cursor-nextjs-tailwind-briefatto-board/)
- [How to create a DESIGN.md from your site or a new brand](https://briefatto.com/guides/how-to-create-a-design-md/)

## Sources

- https://developers.openai.com/codex/guides/agents-md (checked 2026-11-21)
- https://agents.md (checked 2026-11-21)
- https://skills.sh (checked 2026-11-21)
- https://github.com/Briefatto/briefatto-board/blob/main/README.md (checked 2026-11-21)
- https://vite.dev/guide/ (checked 2026-11-21)
- https://vite.dev/config/build-options (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/src/board/standing.ts
- https://github.com/Briefatto/briefatto-board/blob/main/LICENSE

Briefatto Board is independent and is not affiliated with Codex.
