Devbox Documentation
Browse the architecture and operating documentation for hstove/devbox.
Devbox Documentation
This repository includes a Fumadocs site powered by TanStack Start. It renders the repository's Markdown files directly, so documentation remains next to the code and operational configuration it describes.
Local development
Node.js 22 or newer is required.
npm ci
npm run devOpen http://localhost:3000. A production build can be checked with:
npm run build
npm run startCoolify deployment
Create a git-based application in Coolify with these settings:
- Build pack: Nixpacks
- Base directory:
/ - Port:
3000 - Static site: disabled
The committed nixpacks.toml installs with npm ci, builds the Nitro server,
and starts .output/server/index.mjs through the package scripts. No required
application environment variables are needed. Attach a domain in Coolify and
deploy the main branch; Coolify supplies PORT to the Node server.
For deployment troubleshooting and the rationale behind these settings, see Coolify deployment.