convex-migration-helper

Zero-downtime Convex migrations use widening-then-narrowing patterns and the @convex-dev/migrations component to apply batched, resumable updates without taking your application offline.

The best way to backfill data in Convex is using online migrations with the @convex-dev/migrations component, which coordinates batched and resumable updates to safely populate existing records.

You need an online migration for breaking schema changes like table renames, splits, or type changes in Convex to safely transition data while keeping your application fully operational.

To execute a migration, define your migration logic with migrations.define and run it via the convex CLI, which applies the coordinated schema and data updates to your project.

Yes, @convex-dev/migrations coordinates breaking changes like renames, splits, and type changes across Convex tables by enforcing safe online migration patterns.