convex-migrations

Automate batched Convex schema migrations with progress tracking and error handling.

1|1|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/openridesph/openrides --skill convex-migrations-openridesph
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-migrations
Source: https://github.com/openridesph/openrides/tree/main/.agents/skills/convex-migrations
Command: npx skills add https://github.com/openridesph/openrides --skill convex-migrations-openridesph

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Evolve Convex data models safely by applying structured, batched schema migrations that minimize downtime and preserve existing data integrity.

Core Features & Use Cases

  • Pattern-based migrations for adding, removing, renaming fields
  • Batched backfills, index updates, and type conversions with progress tracking
  • Use Case: migrate a users table to add createdAt/updatedAt and backfill existing records without service disruption

Quick Start

Run the migration runner to apply batched schema changes in your Convex deployment.

Frequently Asked Questions about convex-migrations

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run zero-downtime schema migrations in Convex to add new fields?

Zero-downtime schema migrations in Convex use automated batched processing to apply structural data model changes, backfilling existing records with optional fields without disrupting active services.

What is the best way to backfill existing Convex table records after a data model update?

Backfilling Convex table records after a data model update is handled through batched data migrations with built-in progress tracking and error handling, safely transforming existing data.

Can I rename or remove fields in a Convex schema without losing existing data?

You can safely rename or remove fields in a Convex schema using pattern-based batched migrations that preserve existing data integrity while evolving the data model.

Does Convex support batched index updates and type conversions during migrations?

Convex schema migrations support batched index updates and type conversions by utilizing internal Migration utilities and a scheduler to process data model changes safely.

How does progress tracking work during large Convex data migrations?

Progress tracking during Convex data migrations works by monitoring batched backfill operations through internal scheduler utilities, ensuring error handling and safe completion of field transformations.