convex-migrations

Coordinate Convex schema migrations with batched backfills and index changes.

Updated Feb 8, 2026
One-click install
npx skills add https://github.com/Pratikkadam254/LinkedinLeadGen --skill convex-migrations-pratikkadam254
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-migrations
Source: https://github.com/Pratikkadam254/LinkedinLeadGen/tree/main/.claude/skills/convex-migrations
Command: npx skills add https://github.com/Pratikkadam254/LinkedinLeadGen --skill convex-migrations-pratikkadam254

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires convex/server, convex/values.

What problem does it solve?

Helps development teams evolve Convex schemas safely in live deployments by coordinating field additions, backfills, removals, and index changes without downtime or data loss.

Core Features & Use Cases

  • Add optional fields and backfill existing data with zero-downtime migration patterns
  • Remove deprecated fields while keeping code paths compatible
  • Manage index migrations and multi-step field renames with safe, batched execution
  • Track migration progress and recover from failures using a built-in migration runner

Quick Start

Begin by selecting a migration pattern (e.g., add a field), run a batched backfill, and then update your schema.

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?

Zero-downtime Convex schema migrations are coordinated by adding optional fields, running batched backfills, and then updating the schema while keeping code paths compatible. This ensures no data loss or service interruption during live deployments.

What is the best way to backfill existing data when adding a new field in Convex?

Backfilling existing data in Convex is best handled using batched execution patterns. A reusable migration runner tracks progress across batches, allowing you to safely populate new optional fields for existing records without downtime.

Can I remove deprecated fields from a Convex schema without breaking live code?

Yes, you can remove deprecated fields from a Convex schema safely by keeping code paths compatible during the transition. The migration patterns ensure your application continues operating without errors while deprecated fields are phased out.

How does index migration work in Convex?

Index migration in Convex works through safe, batched execution managed by a reusable migration runner. This approach handles index changes and multi-step field renames while tracking progress to ensure zero-downtime schema evolution.

Do I need to take my application offline to update my Convex database schema?

No, you do not need to take your application offline to update a Convex database schema. By coordinating field additions, backfills, and removals with a migration runner, you can evolve schemas safely in live deployments without downtime.