What problem does it solve?
Convex does not use traditional migration files or commands, so manual schema changes risk breaking existing data or causing deployment downtime for production applications. This Skill eliminates that risk by providing proven, safe migration patterns for all common schema evolution tasks.
Core Features & Use Cases
- Safe Field Additions: Add new optional fields to Convex tables and backfill existing data in small batches to avoid function timeouts.
- Deprecated Field Removal: Cleanly remove unused fields from schemas and existing documents only after all code references are updated.
- Zero-Downtime Migrations: Use Convex's built-in scheduler and pagination to run migrations without interrupting live application traffic.
- Use Case: For example, if you need to add a
lastLogin timestamp field to your existing Convex users table, this Skill guides you through adding the optional field, backfilling data for all existing users, and making the field required without any downtime.
Quick Start
Use the convex-migrations skill to add a new optional phoneNumber field to your existing Convex users table and backfill default values for all current users.
