convex-migration-helper

Convex schema migrations require the widen-migrate-narrow workflow to backfill existing documents and adjust schemas across coordinated deployments. This approach uses the migrations component to ensure online safety, monitor progress, and verify completion with a dry run before finalizing changes.

The widen-migrate-narrow workflow is a multi-deploy strategy for backend data migrations that safely widens the schema, backfills existing documents, then narrows the schema after data migration completes. It ensures online migration safety by coordinating deployments and verifying completion with a dry run.

Plan a Convex migration by identifying the required schema change and the data shape to backfill, then apply reusable migration patterns for adding, removing, or renaming fields. Outline the schema change, run a dry-run, and prepare coordinated deployment steps to execute safely.

Yes, you can split data into new tables during a zero-downtime Convex deployment using the migrations component to backfill existing documents. The workflow supports reusable patterns for splitting data while coordinating multi-step deploys to maintain online migration safety.

A dry run is required before finalizing Convex schema changes to verify completion and ensure online migration safety. The workflow monitors progress and validates that backfilled documents and adjusted schemas are coordinated correctly across multi-step deployments before finalizing.