flowpanel

flowpanel ships a small CLI invoked through your package manager. The shipped subcommands are init, migrate, doctor, eject, dev, and new.

flowpanel init

Detect your stack (Next.js, Drizzle/Prisma, auth helper), pick the matching config template, and scaffold the wiring files. Both Drizzle and Prisma are supported in a single command; the CLI picks based on your installed dependencies (Drizzle wins if both are present).

$ pnpm flowpanel init
→ Detected stack: Next.js 15 · TypeScript · Drizzle
→ wrote flowpanel.config.ts
→ wrote app/admin/[[...slug]]/page.tsx
→ wrote app/api/flowpanel/[...route]/route.ts
→ wrote app/api/flowpanel/stream/route.ts
→ wrote styles/admin.css
→ wrote flowpanel/migrations/0001_init.sql

Re-running init is safe: existing files are preserved unless you confirm overwrite (interactive) or pass --yes (CI mode, skips files that exist).

flowpanel migrate

Apply SQL migrations from flowpanel/migrations/. The CLI dynamically imports your flowpanel.config.ts (via jiti) so it can reach the adapter's db instance and run the migration there.

$ pnpm flowpanel migrate
→ 0001_init applied

Use --dry-run to preview the file list without applying anything. The CLI tracks applied IDs in _flowpanel_migrations.

flowpanel doctor

Diagnose common problems: missing peer deps, mismatched Node version, config / schema drift.

$ pnpm flowpanel doctor

Exit code is non-zero when any check fails — wire it into CI to catch drift on every PR.

flowpanel eject

Eject one of three targets — resource, dashboard, or layout — into your repo. See Customization / Eject.

$ pnpm flowpanel eject resource users
$ pnpm flowpanel eject dashboard "/monitoring"
$ pnpm flowpanel eject layout

Pass --force to overwrite existing files.

flowpanel dev

Wrapper around next dev that also spawns bull-board when a scripts/board-server.ts file is present and REDIS_URL is set.

$ pnpm flowpanel dev --port 3000

Pass --no-board to skip the queue dashboard even when Redis is up.

flowpanel new

Append a resource(...) entry to your existing flowpanel.config.ts without re-running init.

$ pnpm flowpanel new posts
→ Added resource "posts" to flowpanel.config.ts

Flags: --table <expr> overrides the first argument (default schema.<resource>); --kind drizzle|prisma toggles the template (default drizzle).