convex-migrations

Automate Convex schema migrations with batch processing and progress tracking.

401|32|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/waynesutton/convexskills --skill convex-migrations-waynesutton
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-migrations
Source: https://github.com/waynesutton/convexskills/tree/main/skills/convex-migrations
Command: npx skills add https://github.com/waynesutton/convexskills --skill convex-migrations-waynesutton

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Safely evolving Convex database schemas during live deployments by coordinating field changes, index updates, and data backfills to avoid downtime and data loss.

Core Features & Use Cases

  • Add and backfill new fields with minimal disruption
  • Remove or rename fields using staged migrations
  • Create and leverage indexes for scalable queries
  • Run batch migrations with progress tracking and error handling
  • Use cases include production schema evolution and incremental data migrations

Quick Start

Start a migration, process data in batches, and mark it complete when all records have been migrated.

Frequently Asked Questions about convex-migrations

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

FAQPage Schema
How do I handle Convex schema migrations without downtime?

Convex schema migrations can be executed without downtime by using batch processing and a reusable runner pattern to coordinate field changes, data backfills, and progress tracking across large datasets during live deployments.

What is the best way to backfill new fields in a Convex database?

Backfilling new fields in a Convex database is best handled through staged migrations that process data in batches, track progress, and ensure idempotent execution to avoid data loss and minimize disruption to production traffic.

How do I safely rename or remove fields in Convex?

To safely rename or remove fields in Convex, use staged migrations that maintain explicit migration state and error handling, ensuring the old field is only removed after the new field is fully populated and verified.

Can I run large batch data migrations with progress tracking in Convex?

Yes, large batch data migrations in Convex can be executed using a migration runner pattern that processes records incrementally, tracks progress across the dataset, and handles errors explicitly to ensure safe rollout.

When do I need to update indexes during Convex schema evolution?

You need to update indexes during Convex schema evolution when adding, removing, or renaming fields that impact query performance, ensuring scalable queries are maintained alongside the structural data changes.