convex-migrations

Safe schema evolution with optional fields, batched backfills, and zero-downtime migration patterns. Evolve your Convex database schema safely with patterns for adding fields, backfilling data, removing deprecated fields, and maintaining zero-downtime deployments. Before implementing, do not assume; fetch the latest documentation: Convex handles schema evolution differently than traditional databases: Start with optional fields, then backfill: Remove field usage before removing from schema: Renaming requires copying data to new field, then removing old: Add indexes before using them in queries: Type changes require careful migration: Create a reusable migration system: - Supports adding fields as optional, backfilling data in batches, renaming fields, removing deprecated fields, and changing field types through multi-step migrations - Includes a migration tracking system to prevent re-running completed migrations and monitor progress across batches - Provides patterns for index management, type conversions with fallback logic, and graceful handling of undefined values during transitions - Uses Convex's scheduler for batched processing of large datasets and internal mutations to coordinate schema changes with data updates - Primary: - Schema Overview: - Migration Patterns: - For broader context: - No explicit migration files or commands - Schema changes deploy instantly with...