Skip to content
Kumiko

kumiko new

Terminal window
kumiko new app <kebab-name> [--dest <dir>]

Creates a standalone app with kumiko.config.ts, src/run-config.ts, bin/main.ts, and the usual .env.example — ready to bun install and bun run boot.

Use this when you’re starting a new product. For a single feature inside an existing app or the framework repo, use kumiko create (recipes) or kumiko add (in-app feature).

Arguments

Section titled “Arguments”
  • app — required subject. Only app is supported today.
  • <kebab-name> — app slug (my-shop, billing-portal).
  • --dest <dir> — output directory. Defaults to ./<kebab-name>/ under CWD.

Example

Section titled “Example”
Terminal window
kumiko new app my-shop
cd my-shop
bun install
cp .env.example .env   # edit JWT_SECRET + KUMIKO_SECRETS_MASTER_KEY_V1
bun run boot

Scaffolded @cosmicdrift/* deps are pinned to the dev-server version you’re running — reproducible installs, not "*".

See also

Section titled “See also”