Upgrade Kumiko dependencies

Standard workflow when bumping @cosmicdrift/kumiko-* deps in an app. Prevents deploying app code that expects new columns against an old DB schema.

Applies to: any app with @cosmicdrift/kumiko-bundled-features (publicstatus, kumiko-studio, customer apps).

Tooling (2026-05): Bun for install/test/build/CLI. Two schema paths coexist — pick the one that matches your app layout.

Which migration path?

Signal in app folder	Path	Generate	Apply (deploy)
drizzle.config.ts + drizzle/migrations/	Legacy (drizzle-kit)	kumiko migrate generate	kumiko migrate apply
kumiko/schema.ts + kumiko/migrations/	New (drizzle-free)	kumiko schema generate <name>	kumiko schema apply

Legacy today: publicstatus, kumiko-studio.

New-path reference: kumiko-framework/samples/apps/use-all-bundled/kumiko/schema.ts.

Run all kumiko … commands from the app directory (CLI uses INIT_CWD):

cd <app>
bun ../kumiko-framework/bin/kumiko.ts <command> …

TL;DR — Legacy (publicstatus, kumiko-studio)

cd publicstatus
# bump all five @cosmicdrift/kumiko-* packages in package.json
bun install
bun ../kumiko-framework/bin/kumiko.ts migrate generate
git diff drizzle/
cd .. && bun check
cd publicstatus && bun test
git add drizzle/ package.json bun.lock
git commit -m "chore: bump kumiko + regen migrations"
git push

CI deploy runs kumiko migrate apply against production before the app starts.

TL;DR — New (kumiko/schema.ts)

cd <app>
bun install
bun ../kumiko-framework/bin/kumiko.ts schema generate bump-0-18-0
git diff kumiko/migrations/
cd .. && bun check && cd <app> && bun test
git add kumiko/migrations/ package.json bun.lock
git commit -m "chore: bump kumiko + schema migration"
git push

Deploy: kumiko schema apply (pre-deploy step, not app boot).

Bump all five packages together

@cosmicdrift/kumiko-framework
@cosmicdrift/kumiko-bundled-features
@cosmicdrift/kumiko-dev-server
@cosmicdrift/kumiko-renderer
@cosmicdrift/kumiko-renderer-web

For 0.x releases, caret ranges may not cross minor bumps — edit package.json explicitly, then bun install and commit bun.lock.

See also

• kumiko schema — drizzle-free migration CLI
• kumiko migrate — legacy drizzle-kit path
• Features and composition — how bundled features mount