How-to guides
Set up a dev environment
Get the docs site running locally, including the linker gotcha.
This page covers this repo (the docs site). For the product app, see Run on Node and the product README.
Install
bun installbunfig.toml must keep linker = "hoisted". With Bun's default isolated
linker, the nitro Vite plugin fails to resolve modules in dev. If you
regenerated bunfig.toml, restore the [install] section.
Run
bun run dev # http://localhost:3000
bun run types:checkOpen http://localhost:3000 — docs content lives under /en/docs and
/pt-BR/docs.
If dev breaks
- Dual React copies — you are probably building with the
cloudflare_modulepreset. Dev must use the defaultvercelpreset; onlybuild:cf/CLOUDFLARE_DEPLOY=1selects Cloudflare. - Stale route tree — delete
src/routeTree.gen.tsand restart; it is generated, never hand-edit it.