Devbox

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 dev

Open http://localhost:3000. A production build can be checked with:

npm run build
npm run start

Coolify 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.

On this page