A scaffolded brust project (the minimal template) looks like this:

my-app/
├── index.ts                 # entry — brust.run({ routes, entry: import.meta.url })
├── routes.tsx               # the route table (defineRoutes)
├── pages/
│   └── Home.tsx             # a native route page (BrustPage document shell)
├── components/
│   └── Counter.tsx          # an island component
├── app.css                  # stylesheet entry (Tailwind v4: @import "tailwindcss")
├── public/
│   └── favicon.svg          # static assets, served at the site root
├── package.json
├── tsconfig.json
└── .gitignore               # ignores node_modules/, .brust/, dist/, brust.toml

Only index.ts and routes.tsx are structurally required; pages/ and components/ are conventions. The scaffolded package.json wires three scripts: dev (brustjs dev), build (brustjs build), and preview (bun run ./dist/index.js).

brust.toml

Server configuration lives in an optional brust.toml at the project root. A missing file is fine — defaults apply.

[server]
address = "0.0.0.0"   # default "localhost"
port = 8080            # default 1337

[workers]
count = 4              # default: one per CPU (availableParallelism)

[cache]
max_entries = 2000     # response cache capacity; default 1000

Precedence, lowest to highest: framework defaults → values passed to brust.run() in code → brust.toml → environment variables. So brust dev --port 3000 (which sets BRUST_PORT) always wins, and a deploy can override everything with BRUST_ADDR / BRUST_PORT / BRUST_WORKERS without touching the file. A present-but-malformed brust.toml is a hard error at boot.

The scaffold gitignores brust.toml, treating it as per-machine configuration; commit it if your team prefers shared settings.

The .brust/ cache directory

brust dev and brust build write compiled artifacts into .brust/ in the working directory. It is gitignored and safe to delete — it is regenerated on the next dev boot or build. Inside you will find, depending on what the app uses:

If a native page renders stale markup after you change the framework or move files around, deleting .brust/ is the reset button.

public/

Files under public/ are served at the site root: public/favicon.svg is available as /favicon.svg. The directory is detected at boot and served by the Rust side with Cache-Control: public, max-age=3600 in production builds (no-store in dev). brust build copies public/ into the output directory so the built app is self-contained.

Next

The full CLI surface: Commands.