Upgrade FlowPanel

FlowPanel workspace packages are released together. Most applications should depend on the umbrella @flowpanel/kit and local @flowpanel/cli at the same version rather than pinning lower-level packages independently.

Inspect the current install

pnpm list "@flowpanel/*"
pnpm flowpanel doctor

Before changing versions, record ejected files and any direct lower-level FlowPanel dependencies. Read the changelog for every version you will cross.

Update aligned packages

pnpm up "@flowpanel/*" --latest
pnpm install

Keep direct FlowPanel packages on the same released version. Multiple copies of @flowpanel/core can split request context and module augmentation; flowpanel doctor checks for that condition.

Review database work

pnpm flowpanel migrate --dry-run

Review pending SQL for the target dialect and deployment strategy before applying it. Back up production data according to the application's normal migration policy, then run pnpm flowpanel migrate in the controlled release step.

Validate the application

Run the application's typecheck and production build. Start the admin once so config compilation can catch duplicate/reserved names, stale columns, and unresolved references. Exercise auth, one scoped read/write, forms, actions, realtime, and queues used by the deployment.

Review ejected files

Ejected files contain a version stamp and are application-owned. The upgrade does not rewrite them. Compare their public imports and behavior with the changelog and current reference; test them separately from generated routes.

If a newer config, renderer, page, or slot now covers the customization, consider returning that surface to generated behavior. Re-enabling config also requires removing the explicit Next.js route.

Pre-1.0 expectations

Before 1.0, minor releases may contain breaking changes. Types and deprecation notes are part of the migration path, but they do not replace the changelog and application tests. Upgrade in a reviewable branch and avoid mixing unrelated dependency changes.

If the installed behavior and current site disagree, use the versioned package types and release notes as the authority and report the documentation mismatch.