convex-migrate

Migre o schema e faça o backfill de dados em um app Convex implantado usando @convex-dev/migrations.

npx skills add https://github.com/get-convex/agent-skills --skill convex-migrate

Migrate the schema / data on a live app

Change a deployed schema without breaking existing data: stage the schema change, install @convex-dev/migrations, write a backfill that makes old rows valid, run it, and verify before tightening the validator.

Workflow

  1. Make the new field optional first (so deploy doesn't reject existing rows).
  2. Install @convex-dev/migrations; write a migration that backfills/transforms existing rows.
  3. Run the migration; verify all rows are valid.
  4. Tighten the validator (make the field required) once the backfill is complete.

Rules

  • Never tighten a validator before the backfill completes — it rejects existing rows and breaks the live app.
  • Add new fields as optional first, migrate, then require.
  • Verify row counts before and after.

Mais skills de get-convex

convex-performance-audit
get-convex
Audita o desempenho do Convex para leituras, assinaturas, contenção de gravação e limites de função. Use para funcionalidades lentas, descobertas de insights, conflitos OCC ou amplificação de leitura.
developmentdatabasedata-analysis
convex
get-convex
Roteia solicitações gerais do Convex para a skill de projeto correta. Use quando o usuário perguntar qual skill do Convex usar ou der uma tarefa de aplicativo Convex subespecificada.
developmentdatabase
convex-setup-auth
get-convex
Configura autenticação Convex, mapeamento de identidade e controle de acesso. Use para login, provedores de autenticação, tabelas de usuários, funções protegidas ou funções em um aplicativo Convex.
developmentdatabaseapi
convex-quickstart
get-convex
Cria ou adiciona Convex a um aplicativo. Use para novos projetos Convex, npm create convex@latest, configuração de frontend, variáveis de ambiente ou a primeira execução do npx convex dev.
developmentdatabase
convex-migration-helper
get-convex
Planeja migrações de esquema e dados do Convex com widen-migrate-narrow e @convex-dev/migrations. Use para mudanças de esquema que quebram compatibilidade, backfills, reformatação de tabelas ou implantações sem tempo de inatividade.
developmentdatabase
convex-create-component
get-convex
Constrói componentes Convex reutilizáveis com tabelas isoladas e APIs voltadas para aplicativos. Use para novos componentes, módulos de backend reutilizáveis, integrações ou trabalho em limites de componentes.
developmentdatabase
convex-optimize
get-convex
Audite e otimize um aplicativo Convex existente: segurança, escala, atualizações, observabilidade.
convex-env
get-convex
Configure e conecte as env vars / secrets de deployment do Convex para o app.