kumiko build

kumiko build [<path>]

Convention-driven production build. Runs Bun.build, the Tailwind compile, and a public-folder copy, then writes everything to dist/.

Path resolution

Source	Used when
<path> arg	If you pass one
$INIT_CWD	Yarn sets this — bun run build runs cleanly from any workspace
process.cwd()	Last resort

In practice: run bun run build inside an app workspace and it Just Works.

Output

✓ build done — 312KB in 1.4s
  out/      dist/
  bundles   client.js, server.js
  static    127 files copied

The output is what you ship — copy dist/ to a container image or upload it to your CDN. No further postprocessing required.

What it does NOT do

• No kumiko codegen step. Run codegen before build if your event types or entity types changed (kumiko codegen && kumiko build).
• No DB migrations. Build is read-only against the DB. Use kumiko migrate apply for that.
• No env validation. Build doesn’t read your .env. The bundle reads it at runtime.

See also

• kumiko codegen — run before build if codegen inputs changed
• Platform docs — how to deploy the resulting dist/