convex-migrations

Migrate Convex database schemas with batch processing and progress tracking.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Schema evolution in dynamic Convex-backed apps can be risky, causing downtime and data inconsistencies during schema changes. This guide outlines proven migration strategies that let you add new fields, backfill existing data, remove deprecated fields, and introduce indexes without service disruption.

Core Features & Use Cases

  • Safe field additions: add optional fields, backfill values, then promote to required.
  • Backfill & migration tracking: process data in batches with progress tracking and error handling.
  • Indexing & schema evolution: create indexes to optimize new queries while migrating data.

Quick Start

Run the migration workflow to add a new field, backfill existing records in batches, then update the schema and verify completion.

Frequently Asked Questions about convex-migrations

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

FAQPage Schema
How do I perform zero-downtime schema migrations in a Convex app?

Zero-downtime schema migrations in a Convex app are performed by adding optional fields, batch backfilling existing data, updating the schema, and verifying completion without disrupting service.

What is the best way to backfill data when adding new fields to a Convex database?

The best way to backfill data in a Convex database is to process records in batches using a dedicated migration mechanism that provides progress tracking and error handling.

Can I create efficient indexes during a Convex schema evolution without downtime?

Yes, you can create efficient indexes during Convex schema evolution to optimize new queries while migrating data, ensuring the process occurs without any service disruption.

How do I safely remove deprecated fields from a Convex database schema?

To safely remove deprecated fields from a Convex database schema, use a dedicated migration mechanism that supports batch processing, error handling, and auditable migrations to prevent data inconsistencies.

Does the Convex migration process track progress and handle errors during batch processing?

Yes, the Convex migration process tracks progress and handles errors during batch processing, providing an auditable mechanism to safely backfill values and evolve schemas.