convex-migration-helper

Use the widen-migrate-narrow workflow with the @convex-dev/migrations component to coordinate schema widening, batched data backfill, and schema narrowing for safe zero-downtime Convex migrations.

The widen-migrate-narrow workflow widens schema to accept both formats, backfills existing documents, and then narrows schema to enforce the new format, preventing downtime and data loss during Convex changes.

Yes, you can backfill existing documents without downtime by using the @convex-dev/migrations component to run batched online migrations that process data while your application continues serving traffic.

Handle breaking schema changes like splitting or merging tables by planning a multi-stage migration that coordinates schema updates and batched data backfilling to maintain availability throughout the table restructure.

Yes, the @convex-dev/migrations component supports dry runs and progress monitoring, allowing you to validate schema changes and data backfill operations before executing them in production.

You need a multi-deploy migration strategy for Convex when applying breaking schema changes, renaming or removing fields, or restructuring tables to ensure zero downtime and prevent data loss.