convex-migrations

Migrate Convex schemas with batched backfills and zero-downtime patterns.

Updated Feb 8, 2026
One-click install
npx skills add https://github.com/not-ani/elevated-school-takehome --skill convex-migrations-not-ani
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-migrations
Source: https://github.com/not-ani/elevated-school-takehome/tree/main/.agents/skills/convex-migrations
Command: npx skills add https://github.com/not-ani/elevated-school-takehome --skill convex-migrations-not-ani

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Migrating Convex schemas can be risky and disruptive; this Skill provides proven patterns for evolving data models without downtime, including safe field changes, backfills, index migrations, and production-ready migration workflows.

Core Features & Use Cases

  • Backward-compatible migrations that add, rename, or remove fields without breaking existing data
  • Batched data backfilling to minimize latency and avoid timeouts
  • Indexed migrations and progress tracking to ensure visibility and reliability
  • Use cases: evolving user profiles, audit trails, and feature flags with zero-downtime rollout

Quick Start

Configure and run a migration to add a new field to a Convex table, backfill existing data in batches, and promote the new field once complete.

Frequently Asked Questions about convex-migrations

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

FAQPage Schema
How do I add a new field to a Convex schema without downtime?

To add a new field to a Convex schema without downtime, apply backward-compatible migration patterns that batch backfill existing data, track progress via optional migration tables, and promote the new field once complete.

What is the safest way to backfill data in Convex?

The safest way to backfill data in Convex is using batched data processing to minimize latency and avoid timeouts, while tracking progress through indexed migration tables to ensure full visibility and reliability.

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

You can remove deprecated fields from a Convex database safely by following zero-downtime deployment workflows that ensure backward compatibility, preventing existing data from breaking during the schema evolution process.

Does Convex support zero-downtime index migrations?

Yes, Convex supports zero-downtime index migrations by applying indexed migrations with progress tracking, ensuring visibility and reliability across projects without disrupting production workloads.

Why do my Convex schema migrations cause timeouts when backfilling?

Convex schema migrations cause timeouts when backfilling if data is processed in large, unbatched transactions; using batched data backfilling minimizes latency and avoids these timeout issues.