[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-convex-convex-migration-helper":3,"mdc-4wndir-key":35,"related-org-convex-convex-migration-helper":1285,"related-repo-convex-convex-migration-helper":1462},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":12,"stars":24,"repoUrl":25,"updatedAt":26,"license":27,"forks":28,"topics":29,"repo":30,"sourceUrl":33,"mdContent":34},"convex-migration-helper","plan Convex schema and data migrations","Plans Convex schema and data migrations with widen-migrate-narrow and @convex-dev\u002Fmigrations. Use for breaking schema changes, backfills, table reshaping, or zero-downtime rollouts.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},"convex","Convex","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fconvex.png","get-convex",[13,17,18,21],{"name":14,"slug":15,"type":16},"Backend","backend","tag",{"name":9,"slug":8,"type":16},{"name":19,"slug":20,"type":16},"Data Engineering","data-engineering",{"name":22,"slug":23,"type":16},"Migration","migration",34,"https:\u002F\u002Fgithub.com\u002Fget-convex\u002Fagent-skills","2026-07-12T08:00:51.27967",null,7,[],{"repoUrl":25,"stars":24,"forks":28,"topics":31,"description":32},[],"Convex Skills for Agents","https:\u002F\u002Fgithub.com\u002Fget-convex\u002Fagent-skills\u002Ftree\u002FHEAD\u002Fskills\u002Fconvex-migration-helper","---\nname: convex-migration-helper\ndescription:\n  Plans Convex schema and data migrations with widen-migrate-narrow and\n  @convex-dev\u002Fmigrations. Use for breaking schema changes, backfills, table\n  reshaping, or zero-downtime rollouts.\n---\n\n# Convex Migration Helper\n\nSafely migrate Convex schemas and data when making breaking changes.\n\n## When to Use\n\n- Adding new required fields to existing tables\n- Changing field types or structure\n- Splitting or merging tables\n- Renaming or deleting fields\n- Migrating from nested to relational data\n\n## When Not to Use\n\n- Greenfield schema with no existing data in production or dev\n- Adding optional fields that do not need backfilling\n- Adding new tables with no existing data to migrate\n- Adding or removing indexes with no correctness concern\n- Questions about Convex schema design without a migration need\n\n## Key Concepts\n\n### Schema Validation Drives the Workflow\n\nConvex will not let you deploy a schema that does not match the data at rest.\nThis is the fundamental constraint that shapes every migration:\n\n- You cannot add a required field if existing documents don't have it\n- You cannot change a field's type if existing documents have the old type\n- You cannot remove a field from the schema if existing documents still have it\n\nThis means migrations follow a predictable pattern: **widen the schema, migrate\nthe data, narrow the schema**.\n\n### Online Migrations\n\nConvex migrations run online, meaning the app continues serving requests while\ndata is updated asynchronously in batches. During the migration window, your\ncode must handle both old and new data formats.\n\n### Prefer New Fields Over Changing Types\n\nWhen changing the shape of data, create a new field rather than modifying an\nexisting one. This makes the transition safer and easier to roll back.\n\n### Don't Delete Data\n\nUnless you are certain, prefer deprecating fields over deleting them. Mark the\nfield as `v.optional` and add a code comment explaining it is deprecated and why\nit existed.\n\n## Safe Changes (No Migration Needed)\n\n### Adding Optional Field\n\n```typescript\n\u002F\u002F Before\nusers: defineTable({\n  name: v.string(),\n});\n\n\u002F\u002F After - safe, new field is optional\nusers: defineTable({\n  name: v.string(),\n  bio: v.optional(v.string()),\n});\n```\n\n### Adding New Table\n\n```typescript\nposts: defineTable({\n  userId: v.id(\"users\"),\n  title: v.string(),\n}).index(\"by_user\", [\"userId\"]);\n```\n\n### Adding Index\n\n```typescript\nusers: defineTable({\n  name: v.string(),\n  email: v.string(),\n}).index(\"by_email\", [\"email\"]);\n```\n\n## Breaking Changes: The Deployment Workflow\n\nEvery breaking migration follows the same multi-deploy pattern:\n\n**Deploy 1 - Widen the schema:**\n\n1. Update schema to allow both old and new formats (e.g., add optional new\n   field)\n2. Update code to handle both formats when reading\n3. Update code to write the new format for new documents\n4. Deploy\n\n**Between deploys - Migrate data:**\n\n5. Run migration to backfill existing documents\n6. Verify all documents are migrated\n\n**Deploy 2 - Narrow the schema:**\n\n7. Update schema to require the new format only\n8. Remove code that handles the old format\n9. Deploy\n\n## Using the Migrations Component\n\nFor any non-trivial migration, use the\n[`@convex-dev\u002Fmigrations`](https:\u002F\u002Fwww.convex.dev\u002Fcomponents\u002Fmigrations)\ncomponent. It handles batching, cursor-based pagination, state tracking, resume\nfrom failure, dry runs, and progress monitoring.\n\nSee `references\u002Fmigrations-component.md` for installation, setup, defining and\nrunning migrations directly with `npx convex run migrations:myMigration`, dry\nruns, status monitoring, and configuration options.\n\n## Common Migration Patterns\n\nSee `references\u002Fmigration-patterns.md` for complete patterns with code examples\ncovering:\n\n- Adding a required field\n- Deleting a field\n- Changing a field type\n- Splitting nested data into a separate table\n- Cleaning up orphaned documents\n- Zero-downtime strategies (dual write, dual read)\n- Small table shortcut (single internalMutation without the component)\n- Verifying a migration is complete\n\n## Common Pitfalls\n\n1. **Making a field required before migrating data**: Convex rejects the deploy\n   because existing documents lack the field. Always widen the schema first.\n2. **Using `.collect()` on large tables**: Hits transaction limits or causes\n   timeouts. Use the migrations component for proper batched pagination.\n   `.collect()` is only safe for tables you know are small.\n3. **Not writing the new format before migrating**: Documents created during the\n   migration window will be missed, leaving unmigrated data after the migration\n   \"completes.\"\n4. **Skipping the dry run**: Use `dryRun: true` to validate migration logic\n   before committing changes to production data. Catches bugs before they touch\n   real documents.\n5. **Deleting fields prematurely**: Prefer deprecating with `v.optional` and a\n   comment. Only delete after you are confident the data is no longer needed and\n   no code references it.\n6. **Using crons for migration batches**: The migrations component handles\n   batching via recursive scheduling internally. Crons require manual cleanup\n   and an extra deploy to remove.\n\n## Migration Checklist\n\n- [ ] Identify the breaking change and plan the multi-deploy workflow\n- [ ] Update schema to allow both old and new formats\n- [ ] Update code to handle both formats when reading\n- [ ] Update code to write the new format for new documents\n- [ ] Deploy widened schema and updated code\n- [ ] Define migration using the `@convex-dev\u002Fmigrations` component\n- [ ] Test with `npx convex run migrations:myMigration '{\"dryRun\": true}'`\n- [ ] Run migration directly with `npx convex run migrations:myMigration` and\n      monitor status\n- [ ] Verify all documents are migrated\n- [ ] Update schema to require new format only\n- [ ] Clean up code that handled old format\n- [ ] Deploy final schema and code\n- [ ] Remove migration code once confirmed stable\n",{"data":36,"body":37},{"name":4,"description":6},{"type":38,"children":39},"root",[40,48,54,61,91,97,125,131,138,143,161,174,180,185,191,196,202,216,222,228,479,485,668,674,832,838,843,851,875,883,896,904,921,927,947,968,974,986,1029,1035,1128,1134,1279],{"type":41,"tag":42,"props":43,"children":44},"element","h1",{"id":4},[45],{"type":46,"value":47},"text","Convex Migration Helper",{"type":41,"tag":49,"props":50,"children":51},"p",{},[52],{"type":46,"value":53},"Safely migrate Convex schemas and data when making breaking changes.",{"type":41,"tag":55,"props":56,"children":58},"h2",{"id":57},"when-to-use",[59],{"type":46,"value":60},"When to Use",{"type":41,"tag":62,"props":63,"children":64},"ul",{},[65,71,76,81,86],{"type":41,"tag":66,"props":67,"children":68},"li",{},[69],{"type":46,"value":70},"Adding new required fields to existing tables",{"type":41,"tag":66,"props":72,"children":73},{},[74],{"type":46,"value":75},"Changing field types or structure",{"type":41,"tag":66,"props":77,"children":78},{},[79],{"type":46,"value":80},"Splitting or merging tables",{"type":41,"tag":66,"props":82,"children":83},{},[84],{"type":46,"value":85},"Renaming or deleting fields",{"type":41,"tag":66,"props":87,"children":88},{},[89],{"type":46,"value":90},"Migrating from nested to relational data",{"type":41,"tag":55,"props":92,"children":94},{"id":93},"when-not-to-use",[95],{"type":46,"value":96},"When Not to Use",{"type":41,"tag":62,"props":98,"children":99},{},[100,105,110,115,120],{"type":41,"tag":66,"props":101,"children":102},{},[103],{"type":46,"value":104},"Greenfield schema with no existing data in production or dev",{"type":41,"tag":66,"props":106,"children":107},{},[108],{"type":46,"value":109},"Adding optional fields that do not need backfilling",{"type":41,"tag":66,"props":111,"children":112},{},[113],{"type":46,"value":114},"Adding new tables with no existing data to migrate",{"type":41,"tag":66,"props":116,"children":117},{},[118],{"type":46,"value":119},"Adding or removing indexes with no correctness concern",{"type":41,"tag":66,"props":121,"children":122},{},[123],{"type":46,"value":124},"Questions about Convex schema design without a migration need",{"type":41,"tag":55,"props":126,"children":128},{"id":127},"key-concepts",[129],{"type":46,"value":130},"Key Concepts",{"type":41,"tag":132,"props":133,"children":135},"h3",{"id":134},"schema-validation-drives-the-workflow",[136],{"type":46,"value":137},"Schema Validation Drives the Workflow",{"type":41,"tag":49,"props":139,"children":140},{},[141],{"type":46,"value":142},"Convex will not let you deploy a schema that does not match the data at rest.\nThis is the fundamental constraint that shapes every migration:",{"type":41,"tag":62,"props":144,"children":145},{},[146,151,156],{"type":41,"tag":66,"props":147,"children":148},{},[149],{"type":46,"value":150},"You cannot add a required field if existing documents don't have it",{"type":41,"tag":66,"props":152,"children":153},{},[154],{"type":46,"value":155},"You cannot change a field's type if existing documents have the old type",{"type":41,"tag":66,"props":157,"children":158},{},[159],{"type":46,"value":160},"You cannot remove a field from the schema if existing documents still have it",{"type":41,"tag":49,"props":162,"children":163},{},[164,166,172],{"type":46,"value":165},"This means migrations follow a predictable pattern: ",{"type":41,"tag":167,"props":168,"children":169},"strong",{},[170],{"type":46,"value":171},"widen the schema, migrate\nthe data, narrow the schema",{"type":46,"value":173},".",{"type":41,"tag":132,"props":175,"children":177},{"id":176},"online-migrations",[178],{"type":46,"value":179},"Online Migrations",{"type":41,"tag":49,"props":181,"children":182},{},[183],{"type":46,"value":184},"Convex migrations run online, meaning the app continues serving requests while\ndata is updated asynchronously in batches. During the migration window, your\ncode must handle both old and new data formats.",{"type":41,"tag":132,"props":186,"children":188},{"id":187},"prefer-new-fields-over-changing-types",[189],{"type":46,"value":190},"Prefer New Fields Over Changing Types",{"type":41,"tag":49,"props":192,"children":193},{},[194],{"type":46,"value":195},"When changing the shape of data, create a new field rather than modifying an\nexisting one. This makes the transition safer and easier to roll back.",{"type":41,"tag":132,"props":197,"children":199},{"id":198},"dont-delete-data",[200],{"type":46,"value":201},"Don't Delete Data",{"type":41,"tag":49,"props":203,"children":204},{},[205,207,214],{"type":46,"value":206},"Unless you are certain, prefer deprecating fields over deleting them. Mark the\nfield as ",{"type":41,"tag":208,"props":209,"children":211},"code",{"className":210},[],[212],{"type":46,"value":213},"v.optional",{"type":46,"value":215}," and add a code comment explaining it is deprecated and why\nit existed.",{"type":41,"tag":55,"props":217,"children":219},{"id":218},"safe-changes-no-migration-needed",[220],{"type":46,"value":221},"Safe Changes (No Migration Needed)",{"type":41,"tag":132,"props":223,"children":225},{"id":224},"adding-optional-field",[226],{"type":46,"value":227},"Adding Optional Field",{"type":41,"tag":229,"props":230,"children":235},"pre",{"className":231,"code":232,"language":233,"meta":234,"style":234},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u002F\u002F Before\nusers: defineTable({\n  name: v.string(),\n});\n\n\u002F\u002F After - safe, new field is optional\nusers: defineTable({\n  name: v.string(),\n  bio: v.optional(v.string()),\n});\n","typescript","",[236],{"type":41,"tag":208,"props":237,"children":238},{"__ignoreMap":234},[239,251,284,322,341,351,360,383,415,463],{"type":41,"tag":240,"props":241,"children":244},"span",{"class":242,"line":243},"line",1,[245],{"type":41,"tag":240,"props":246,"children":248},{"style":247},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[249],{"type":46,"value":250},"\u002F\u002F Before\n",{"type":41,"tag":240,"props":252,"children":254},{"class":242,"line":253},2,[255,261,267,273,279],{"type":41,"tag":240,"props":256,"children":258},{"style":257},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[259],{"type":46,"value":260},"users",{"type":41,"tag":240,"props":262,"children":264},{"style":263},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[265],{"type":46,"value":266},":",{"type":41,"tag":240,"props":268,"children":270},{"style":269},"--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF",[271],{"type":46,"value":272}," defineTable",{"type":41,"tag":240,"props":274,"children":276},{"style":275},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[277],{"type":46,"value":278},"(",{"type":41,"tag":240,"props":280,"children":281},{"style":263},[282],{"type":46,"value":283},"{\n",{"type":41,"tag":240,"props":285,"children":287},{"class":242,"line":286},3,[288,294,298,303,307,312,317],{"type":41,"tag":240,"props":289,"children":291},{"style":290},"--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178",[292],{"type":46,"value":293},"  name",{"type":41,"tag":240,"props":295,"children":296},{"style":263},[297],{"type":46,"value":266},{"type":41,"tag":240,"props":299,"children":300},{"style":275},[301],{"type":46,"value":302}," v",{"type":41,"tag":240,"props":304,"children":305},{"style":263},[306],{"type":46,"value":173},{"type":41,"tag":240,"props":308,"children":309},{"style":269},[310],{"type":46,"value":311},"string",{"type":41,"tag":240,"props":313,"children":314},{"style":275},[315],{"type":46,"value":316},"()",{"type":41,"tag":240,"props":318,"children":319},{"style":263},[320],{"type":46,"value":321},",\n",{"type":41,"tag":240,"props":323,"children":325},{"class":242,"line":324},4,[326,331,336],{"type":41,"tag":240,"props":327,"children":328},{"style":263},[329],{"type":46,"value":330},"}",{"type":41,"tag":240,"props":332,"children":333},{"style":275},[334],{"type":46,"value":335},")",{"type":41,"tag":240,"props":337,"children":338},{"style":263},[339],{"type":46,"value":340},";\n",{"type":41,"tag":240,"props":342,"children":344},{"class":242,"line":343},5,[345],{"type":41,"tag":240,"props":346,"children":348},{"emptyLinePlaceholder":347},true,[349],{"type":46,"value":350},"\n",{"type":41,"tag":240,"props":352,"children":354},{"class":242,"line":353},6,[355],{"type":41,"tag":240,"props":356,"children":357},{"style":247},[358],{"type":46,"value":359},"\u002F\u002F After - safe, new field is optional\n",{"type":41,"tag":240,"props":361,"children":362},{"class":242,"line":28},[363,367,371,375,379],{"type":41,"tag":240,"props":364,"children":365},{"style":257},[366],{"type":46,"value":260},{"type":41,"tag":240,"props":368,"children":369},{"style":263},[370],{"type":46,"value":266},{"type":41,"tag":240,"props":372,"children":373},{"style":269},[374],{"type":46,"value":272},{"type":41,"tag":240,"props":376,"children":377},{"style":275},[378],{"type":46,"value":278},{"type":41,"tag":240,"props":380,"children":381},{"style":263},[382],{"type":46,"value":283},{"type":41,"tag":240,"props":384,"children":386},{"class":242,"line":385},8,[387,391,395,399,403,407,411],{"type":41,"tag":240,"props":388,"children":389},{"style":290},[390],{"type":46,"value":293},{"type":41,"tag":240,"props":392,"children":393},{"style":263},[394],{"type":46,"value":266},{"type":41,"tag":240,"props":396,"children":397},{"style":275},[398],{"type":46,"value":302},{"type":41,"tag":240,"props":400,"children":401},{"style":263},[402],{"type":46,"value":173},{"type":41,"tag":240,"props":404,"children":405},{"style":269},[406],{"type":46,"value":311},{"type":41,"tag":240,"props":408,"children":409},{"style":275},[410],{"type":46,"value":316},{"type":41,"tag":240,"props":412,"children":413},{"style":263},[414],{"type":46,"value":321},{"type":41,"tag":240,"props":416,"children":418},{"class":242,"line":417},9,[419,424,428,432,436,441,446,450,454,459],{"type":41,"tag":240,"props":420,"children":421},{"style":290},[422],{"type":46,"value":423},"  bio",{"type":41,"tag":240,"props":425,"children":426},{"style":263},[427],{"type":46,"value":266},{"type":41,"tag":240,"props":429,"children":430},{"style":275},[431],{"type":46,"value":302},{"type":41,"tag":240,"props":433,"children":434},{"style":263},[435],{"type":46,"value":173},{"type":41,"tag":240,"props":437,"children":438},{"style":269},[439],{"type":46,"value":440},"optional",{"type":41,"tag":240,"props":442,"children":443},{"style":275},[444],{"type":46,"value":445},"(v",{"type":41,"tag":240,"props":447,"children":448},{"style":263},[449],{"type":46,"value":173},{"type":41,"tag":240,"props":451,"children":452},{"style":269},[453],{"type":46,"value":311},{"type":41,"tag":240,"props":455,"children":456},{"style":275},[457],{"type":46,"value":458},"())",{"type":41,"tag":240,"props":460,"children":461},{"style":263},[462],{"type":46,"value":321},{"type":41,"tag":240,"props":464,"children":466},{"class":242,"line":465},10,[467,471,475],{"type":41,"tag":240,"props":468,"children":469},{"style":263},[470],{"type":46,"value":330},{"type":41,"tag":240,"props":472,"children":473},{"style":275},[474],{"type":46,"value":335},{"type":41,"tag":240,"props":476,"children":477},{"style":263},[478],{"type":46,"value":340},{"type":41,"tag":132,"props":480,"children":482},{"id":481},"adding-new-table",[483],{"type":46,"value":484},"Adding New Table",{"type":41,"tag":229,"props":486,"children":488},{"className":231,"code":487,"language":233,"meta":234,"style":234},"posts: defineTable({\n  userId: v.id(\"users\"),\n  title: v.string(),\n}).index(\"by_user\", [\"userId\"]);\n",[489],{"type":41,"tag":208,"props":490,"children":491},{"__ignoreMap":234},[492,516,567,599],{"type":41,"tag":240,"props":493,"children":494},{"class":242,"line":243},[495,500,504,508,512],{"type":41,"tag":240,"props":496,"children":497},{"style":257},[498],{"type":46,"value":499},"posts",{"type":41,"tag":240,"props":501,"children":502},{"style":263},[503],{"type":46,"value":266},{"type":41,"tag":240,"props":505,"children":506},{"style":269},[507],{"type":46,"value":272},{"type":41,"tag":240,"props":509,"children":510},{"style":275},[511],{"type":46,"value":278},{"type":41,"tag":240,"props":513,"children":514},{"style":263},[515],{"type":46,"value":283},{"type":41,"tag":240,"props":517,"children":518},{"class":242,"line":253},[519,524,528,532,536,541,545,550,555,559,563],{"type":41,"tag":240,"props":520,"children":521},{"style":290},[522],{"type":46,"value":523},"  userId",{"type":41,"tag":240,"props":525,"children":526},{"style":263},[527],{"type":46,"value":266},{"type":41,"tag":240,"props":529,"children":530},{"style":275},[531],{"type":46,"value":302},{"type":41,"tag":240,"props":533,"children":534},{"style":263},[535],{"type":46,"value":173},{"type":41,"tag":240,"props":537,"children":538},{"style":269},[539],{"type":46,"value":540},"id",{"type":41,"tag":240,"props":542,"children":543},{"style":275},[544],{"type":46,"value":278},{"type":41,"tag":240,"props":546,"children":547},{"style":263},[548],{"type":46,"value":549},"\"",{"type":41,"tag":240,"props":551,"children":553},{"style":552},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[554],{"type":46,"value":260},{"type":41,"tag":240,"props":556,"children":557},{"style":263},[558],{"type":46,"value":549},{"type":41,"tag":240,"props":560,"children":561},{"style":275},[562],{"type":46,"value":335},{"type":41,"tag":240,"props":564,"children":565},{"style":263},[566],{"type":46,"value":321},{"type":41,"tag":240,"props":568,"children":569},{"class":242,"line":286},[570,575,579,583,587,591,595],{"type":41,"tag":240,"props":571,"children":572},{"style":290},[573],{"type":46,"value":574},"  title",{"type":41,"tag":240,"props":576,"children":577},{"style":263},[578],{"type":46,"value":266},{"type":41,"tag":240,"props":580,"children":581},{"style":275},[582],{"type":46,"value":302},{"type":41,"tag":240,"props":584,"children":585},{"style":263},[586],{"type":46,"value":173},{"type":41,"tag":240,"props":588,"children":589},{"style":269},[590],{"type":46,"value":311},{"type":41,"tag":240,"props":592,"children":593},{"style":275},[594],{"type":46,"value":316},{"type":41,"tag":240,"props":596,"children":597},{"style":263},[598],{"type":46,"value":321},{"type":41,"tag":240,"props":600,"children":601},{"class":242,"line":324},[602,606,610,614,619,623,627,632,636,641,646,650,655,659,664],{"type":41,"tag":240,"props":603,"children":604},{"style":263},[605],{"type":46,"value":330},{"type":41,"tag":240,"props":607,"children":608},{"style":275},[609],{"type":46,"value":335},{"type":41,"tag":240,"props":611,"children":612},{"style":263},[613],{"type":46,"value":173},{"type":41,"tag":240,"props":615,"children":616},{"style":269},[617],{"type":46,"value":618},"index",{"type":41,"tag":240,"props":620,"children":621},{"style":275},[622],{"type":46,"value":278},{"type":41,"tag":240,"props":624,"children":625},{"style":263},[626],{"type":46,"value":549},{"type":41,"tag":240,"props":628,"children":629},{"style":552},[630],{"type":46,"value":631},"by_user",{"type":41,"tag":240,"props":633,"children":634},{"style":263},[635],{"type":46,"value":549},{"type":41,"tag":240,"props":637,"children":638},{"style":263},[639],{"type":46,"value":640},",",{"type":41,"tag":240,"props":642,"children":643},{"style":275},[644],{"type":46,"value":645}," [",{"type":41,"tag":240,"props":647,"children":648},{"style":263},[649],{"type":46,"value":549},{"type":41,"tag":240,"props":651,"children":652},{"style":552},[653],{"type":46,"value":654},"userId",{"type":41,"tag":240,"props":656,"children":657},{"style":263},[658],{"type":46,"value":549},{"type":41,"tag":240,"props":660,"children":661},{"style":275},[662],{"type":46,"value":663},"])",{"type":41,"tag":240,"props":665,"children":666},{"style":263},[667],{"type":46,"value":340},{"type":41,"tag":132,"props":669,"children":671},{"id":670},"adding-index",[672],{"type":46,"value":673},"Adding Index",{"type":41,"tag":229,"props":675,"children":677},{"className":231,"code":676,"language":233,"meta":234,"style":234},"users: defineTable({\n  name: v.string(),\n  email: v.string(),\n}).index(\"by_email\", [\"email\"]);\n",[678],{"type":41,"tag":208,"props":679,"children":680},{"__ignoreMap":234},[681,704,735,767],{"type":41,"tag":240,"props":682,"children":683},{"class":242,"line":243},[684,688,692,696,700],{"type":41,"tag":240,"props":685,"children":686},{"style":257},[687],{"type":46,"value":260},{"type":41,"tag":240,"props":689,"children":690},{"style":263},[691],{"type":46,"value":266},{"type":41,"tag":240,"props":693,"children":694},{"style":269},[695],{"type":46,"value":272},{"type":41,"tag":240,"props":697,"children":698},{"style":275},[699],{"type":46,"value":278},{"type":41,"tag":240,"props":701,"children":702},{"style":263},[703],{"type":46,"value":283},{"type":41,"tag":240,"props":705,"children":706},{"class":242,"line":253},[707,711,715,719,723,727,731],{"type":41,"tag":240,"props":708,"children":709},{"style":290},[710],{"type":46,"value":293},{"type":41,"tag":240,"props":712,"children":713},{"style":263},[714],{"type":46,"value":266},{"type":41,"tag":240,"props":716,"children":717},{"style":275},[718],{"type":46,"value":302},{"type":41,"tag":240,"props":720,"children":721},{"style":263},[722],{"type":46,"value":173},{"type":41,"tag":240,"props":724,"children":725},{"style":269},[726],{"type":46,"value":311},{"type":41,"tag":240,"props":728,"children":729},{"style":275},[730],{"type":46,"value":316},{"type":41,"tag":240,"props":732,"children":733},{"style":263},[734],{"type":46,"value":321},{"type":41,"tag":240,"props":736,"children":737},{"class":242,"line":286},[738,743,747,751,755,759,763],{"type":41,"tag":240,"props":739,"children":740},{"style":290},[741],{"type":46,"value":742},"  email",{"type":41,"tag":240,"props":744,"children":745},{"style":263},[746],{"type":46,"value":266},{"type":41,"tag":240,"props":748,"children":749},{"style":275},[750],{"type":46,"value":302},{"type":41,"tag":240,"props":752,"children":753},{"style":263},[754],{"type":46,"value":173},{"type":41,"tag":240,"props":756,"children":757},{"style":269},[758],{"type":46,"value":311},{"type":41,"tag":240,"props":760,"children":761},{"style":275},[762],{"type":46,"value":316},{"type":41,"tag":240,"props":764,"children":765},{"style":263},[766],{"type":46,"value":321},{"type":41,"tag":240,"props":768,"children":769},{"class":242,"line":324},[770,774,778,782,786,790,794,799,803,807,811,815,820,824,828],{"type":41,"tag":240,"props":771,"children":772},{"style":263},[773],{"type":46,"value":330},{"type":41,"tag":240,"props":775,"children":776},{"style":275},[777],{"type":46,"value":335},{"type":41,"tag":240,"props":779,"children":780},{"style":263},[781],{"type":46,"value":173},{"type":41,"tag":240,"props":783,"children":784},{"style":269},[785],{"type":46,"value":618},{"type":41,"tag":240,"props":787,"children":788},{"style":275},[789],{"type":46,"value":278},{"type":41,"tag":240,"props":791,"children":792},{"style":263},[793],{"type":46,"value":549},{"type":41,"tag":240,"props":795,"children":796},{"style":552},[797],{"type":46,"value":798},"by_email",{"type":41,"tag":240,"props":800,"children":801},{"style":263},[802],{"type":46,"value":549},{"type":41,"tag":240,"props":804,"children":805},{"style":263},[806],{"type":46,"value":640},{"type":41,"tag":240,"props":808,"children":809},{"style":275},[810],{"type":46,"value":645},{"type":41,"tag":240,"props":812,"children":813},{"style":263},[814],{"type":46,"value":549},{"type":41,"tag":240,"props":816,"children":817},{"style":552},[818],{"type":46,"value":819},"email",{"type":41,"tag":240,"props":821,"children":822},{"style":263},[823],{"type":46,"value":549},{"type":41,"tag":240,"props":825,"children":826},{"style":275},[827],{"type":46,"value":663},{"type":41,"tag":240,"props":829,"children":830},{"style":263},[831],{"type":46,"value":340},{"type":41,"tag":55,"props":833,"children":835},{"id":834},"breaking-changes-the-deployment-workflow",[836],{"type":46,"value":837},"Breaking Changes: The Deployment Workflow",{"type":41,"tag":49,"props":839,"children":840},{},[841],{"type":46,"value":842},"Every breaking migration follows the same multi-deploy pattern:",{"type":41,"tag":49,"props":844,"children":845},{},[846],{"type":41,"tag":167,"props":847,"children":848},{},[849],{"type":46,"value":850},"Deploy 1 - Widen the schema:",{"type":41,"tag":852,"props":853,"children":854},"ol",{},[855,860,865,870],{"type":41,"tag":66,"props":856,"children":857},{},[858],{"type":46,"value":859},"Update schema to allow both old and new formats (e.g., add optional new\nfield)",{"type":41,"tag":66,"props":861,"children":862},{},[863],{"type":46,"value":864},"Update code to handle both formats when reading",{"type":41,"tag":66,"props":866,"children":867},{},[868],{"type":46,"value":869},"Update code to write the new format for new documents",{"type":41,"tag":66,"props":871,"children":872},{},[873],{"type":46,"value":874},"Deploy",{"type":41,"tag":49,"props":876,"children":877},{},[878],{"type":41,"tag":167,"props":879,"children":880},{},[881],{"type":46,"value":882},"Between deploys - Migrate data:",{"type":41,"tag":852,"props":884,"children":885},{"start":343},[886,891],{"type":41,"tag":66,"props":887,"children":888},{},[889],{"type":46,"value":890},"Run migration to backfill existing documents",{"type":41,"tag":66,"props":892,"children":893},{},[894],{"type":46,"value":895},"Verify all documents are migrated",{"type":41,"tag":49,"props":897,"children":898},{},[899],{"type":41,"tag":167,"props":900,"children":901},{},[902],{"type":46,"value":903},"Deploy 2 - Narrow the schema:",{"type":41,"tag":852,"props":905,"children":906},{"start":28},[907,912,917],{"type":41,"tag":66,"props":908,"children":909},{},[910],{"type":46,"value":911},"Update schema to require the new format only",{"type":41,"tag":66,"props":913,"children":914},{},[915],{"type":46,"value":916},"Remove code that handles the old format",{"type":41,"tag":66,"props":918,"children":919},{},[920],{"type":46,"value":874},{"type":41,"tag":55,"props":922,"children":924},{"id":923},"using-the-migrations-component",[925],{"type":46,"value":926},"Using the Migrations Component",{"type":41,"tag":49,"props":928,"children":929},{},[930,932,945],{"type":46,"value":931},"For any non-trivial migration, use the\n",{"type":41,"tag":933,"props":934,"children":938},"a",{"href":935,"rel":936},"https:\u002F\u002Fwww.convex.dev\u002Fcomponents\u002Fmigrations",[937],"nofollow",[939],{"type":41,"tag":208,"props":940,"children":942},{"className":941},[],[943],{"type":46,"value":944},"@convex-dev\u002Fmigrations",{"type":46,"value":946},"\ncomponent. It handles batching, cursor-based pagination, state tracking, resume\nfrom failure, dry runs, and progress monitoring.",{"type":41,"tag":49,"props":948,"children":949},{},[950,952,958,960,966],{"type":46,"value":951},"See ",{"type":41,"tag":208,"props":953,"children":955},{"className":954},[],[956],{"type":46,"value":957},"references\u002Fmigrations-component.md",{"type":46,"value":959}," for installation, setup, defining and\nrunning migrations directly with ",{"type":41,"tag":208,"props":961,"children":963},{"className":962},[],[964],{"type":46,"value":965},"npx convex run migrations:myMigration",{"type":46,"value":967},", dry\nruns, status monitoring, and configuration options.",{"type":41,"tag":55,"props":969,"children":971},{"id":970},"common-migration-patterns",[972],{"type":46,"value":973},"Common Migration Patterns",{"type":41,"tag":49,"props":975,"children":976},{},[977,978,984],{"type":46,"value":951},{"type":41,"tag":208,"props":979,"children":981},{"className":980},[],[982],{"type":46,"value":983},"references\u002Fmigration-patterns.md",{"type":46,"value":985}," for complete patterns with code examples\ncovering:",{"type":41,"tag":62,"props":987,"children":988},{},[989,994,999,1004,1009,1014,1019,1024],{"type":41,"tag":66,"props":990,"children":991},{},[992],{"type":46,"value":993},"Adding a required field",{"type":41,"tag":66,"props":995,"children":996},{},[997],{"type":46,"value":998},"Deleting a field",{"type":41,"tag":66,"props":1000,"children":1001},{},[1002],{"type":46,"value":1003},"Changing a field type",{"type":41,"tag":66,"props":1005,"children":1006},{},[1007],{"type":46,"value":1008},"Splitting nested data into a separate table",{"type":41,"tag":66,"props":1010,"children":1011},{},[1012],{"type":46,"value":1013},"Cleaning up orphaned documents",{"type":41,"tag":66,"props":1015,"children":1016},{},[1017],{"type":46,"value":1018},"Zero-downtime strategies (dual write, dual read)",{"type":41,"tag":66,"props":1020,"children":1021},{},[1022],{"type":46,"value":1023},"Small table shortcut (single internalMutation without the component)",{"type":41,"tag":66,"props":1025,"children":1026},{},[1027],{"type":46,"value":1028},"Verifying a migration is complete",{"type":41,"tag":55,"props":1030,"children":1032},{"id":1031},"common-pitfalls",[1033],{"type":46,"value":1034},"Common Pitfalls",{"type":41,"tag":852,"props":1036,"children":1037},{},[1038,1048,1073,1083,1101,1118],{"type":41,"tag":66,"props":1039,"children":1040},{},[1041,1046],{"type":41,"tag":167,"props":1042,"children":1043},{},[1044],{"type":46,"value":1045},"Making a field required before migrating data",{"type":46,"value":1047},": Convex rejects the deploy\nbecause existing documents lack the field. Always widen the schema first.",{"type":41,"tag":66,"props":1049,"children":1050},{},[1051,1064,1066,1071],{"type":41,"tag":167,"props":1052,"children":1053},{},[1054,1056,1062],{"type":46,"value":1055},"Using ",{"type":41,"tag":208,"props":1057,"children":1059},{"className":1058},[],[1060],{"type":46,"value":1061},".collect()",{"type":46,"value":1063}," on large tables",{"type":46,"value":1065},": Hits transaction limits or causes\ntimeouts. Use the migrations component for proper batched pagination.\n",{"type":41,"tag":208,"props":1067,"children":1069},{"className":1068},[],[1070],{"type":46,"value":1061},{"type":46,"value":1072}," is only safe for tables you know are small.",{"type":41,"tag":66,"props":1074,"children":1075},{},[1076,1081],{"type":41,"tag":167,"props":1077,"children":1078},{},[1079],{"type":46,"value":1080},"Not writing the new format before migrating",{"type":46,"value":1082},": Documents created during the\nmigration window will be missed, leaving unmigrated data after the migration\n\"completes.\"",{"type":41,"tag":66,"props":1084,"children":1085},{},[1086,1091,1093,1099],{"type":41,"tag":167,"props":1087,"children":1088},{},[1089],{"type":46,"value":1090},"Skipping the dry run",{"type":46,"value":1092},": Use ",{"type":41,"tag":208,"props":1094,"children":1096},{"className":1095},[],[1097],{"type":46,"value":1098},"dryRun: true",{"type":46,"value":1100}," to validate migration logic\nbefore committing changes to production data. Catches bugs before they touch\nreal documents.",{"type":41,"tag":66,"props":1102,"children":1103},{},[1104,1109,1111,1116],{"type":41,"tag":167,"props":1105,"children":1106},{},[1107],{"type":46,"value":1108},"Deleting fields prematurely",{"type":46,"value":1110},": Prefer deprecating with ",{"type":41,"tag":208,"props":1112,"children":1114},{"className":1113},[],[1115],{"type":46,"value":213},{"type":46,"value":1117}," and a\ncomment. Only delete after you are confident the data is no longer needed and\nno code references it.",{"type":41,"tag":66,"props":1119,"children":1120},{},[1121,1126],{"type":41,"tag":167,"props":1122,"children":1123},{},[1124],{"type":46,"value":1125},"Using crons for migration batches",{"type":46,"value":1127},": The migrations component handles\nbatching via recursive scheduling internally. Crons require manual cleanup\nand an extra deploy to remove.",{"type":41,"tag":55,"props":1129,"children":1131},{"id":1130},"migration-checklist",[1132],{"type":46,"value":1133},"Migration Checklist",{"type":41,"tag":62,"props":1135,"children":1138},{"className":1136},[1137],"contains-task-list",[1139,1151,1160,1169,1178,1187,1203,1218,1234,1243,1252,1261,1270],{"type":41,"tag":66,"props":1140,"children":1143},{"className":1141},[1142],"task-list-item",[1144,1149],{"type":41,"tag":1145,"props":1146,"children":1148},"input",{"disabled":347,"type":1147},"checkbox",[],{"type":46,"value":1150}," Identify the breaking change and plan the multi-deploy workflow",{"type":41,"tag":66,"props":1152,"children":1154},{"className":1153},[1142],[1155,1158],{"type":41,"tag":1145,"props":1156,"children":1157},{"disabled":347,"type":1147},[],{"type":46,"value":1159}," Update schema to allow both old and new formats",{"type":41,"tag":66,"props":1161,"children":1163},{"className":1162},[1142],[1164,1167],{"type":41,"tag":1145,"props":1165,"children":1166},{"disabled":347,"type":1147},[],{"type":46,"value":1168}," Update code to handle both formats when reading",{"type":41,"tag":66,"props":1170,"children":1172},{"className":1171},[1142],[1173,1176],{"type":41,"tag":1145,"props":1174,"children":1175},{"disabled":347,"type":1147},[],{"type":46,"value":1177}," Update code to write the new format for new documents",{"type":41,"tag":66,"props":1179,"children":1181},{"className":1180},[1142],[1182,1185],{"type":41,"tag":1145,"props":1183,"children":1184},{"disabled":347,"type":1147},[],{"type":46,"value":1186}," Deploy widened schema and updated code",{"type":41,"tag":66,"props":1188,"children":1190},{"className":1189},[1142],[1191,1194,1196,1201],{"type":41,"tag":1145,"props":1192,"children":1193},{"disabled":347,"type":1147},[],{"type":46,"value":1195}," Define migration using the ",{"type":41,"tag":208,"props":1197,"children":1199},{"className":1198},[],[1200],{"type":46,"value":944},{"type":46,"value":1202}," component",{"type":41,"tag":66,"props":1204,"children":1206},{"className":1205},[1142],[1207,1210,1212],{"type":41,"tag":1145,"props":1208,"children":1209},{"disabled":347,"type":1147},[],{"type":46,"value":1211}," Test with ",{"type":41,"tag":208,"props":1213,"children":1215},{"className":1214},[],[1216],{"type":46,"value":1217},"npx convex run migrations:myMigration '{\"dryRun\": true}'",{"type":41,"tag":66,"props":1219,"children":1221},{"className":1220},[1142],[1222,1225,1227,1232],{"type":41,"tag":1145,"props":1223,"children":1224},{"disabled":347,"type":1147},[],{"type":46,"value":1226}," Run migration directly with ",{"type":41,"tag":208,"props":1228,"children":1230},{"className":1229},[],[1231],{"type":46,"value":965},{"type":46,"value":1233}," and\nmonitor status",{"type":41,"tag":66,"props":1235,"children":1237},{"className":1236},[1142],[1238,1241],{"type":41,"tag":1145,"props":1239,"children":1240},{"disabled":347,"type":1147},[],{"type":46,"value":1242}," Verify all documents are migrated",{"type":41,"tag":66,"props":1244,"children":1246},{"className":1245},[1142],[1247,1250],{"type":41,"tag":1145,"props":1248,"children":1249},{"disabled":347,"type":1147},[],{"type":46,"value":1251}," Update schema to require new format only",{"type":41,"tag":66,"props":1253,"children":1255},{"className":1254},[1142],[1256,1259],{"type":41,"tag":1145,"props":1257,"children":1258},{"disabled":347,"type":1147},[],{"type":46,"value":1260}," Clean up code that handled old format",{"type":41,"tag":66,"props":1262,"children":1264},{"className":1263},[1142],[1265,1268],{"type":41,"tag":1145,"props":1266,"children":1267},{"disabled":347,"type":1147},[],{"type":46,"value":1269}," Deploy final schema and code",{"type":41,"tag":66,"props":1271,"children":1273},{"className":1272},[1142],[1274,1277],{"type":41,"tag":1145,"props":1275,"children":1276},{"disabled":347,"type":1147},[],{"type":46,"value":1278}," Remove migration code once confirmed stable",{"type":41,"tag":1280,"props":1281,"children":1282},"style",{},[1283],{"type":46,"value":1284},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":1286,"total":1461},[1287,1298,1313,1320,1337,1354,1369,1382,1401,1415,1432,1446],{"slug":8,"name":8,"fn":1288,"description":1289,"org":1290,"tags":1291,"stars":24,"repoUrl":25,"updatedAt":1297},"guide Convex project setup and usage","Routes general Convex requests to the right project skill. Use when the user asks which Convex skill to use or gives an underspecified Convex app task.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1292,1293,1294],{"name":14,"slug":15,"type":16},{"name":9,"slug":8,"type":16},{"name":1295,"slug":1296,"type":16},"Database","database","2026-07-12T08:00:45.091281",{"slug":1299,"name":1299,"fn":1300,"description":1301,"org":1302,"tags":1303,"stars":24,"repoUrl":25,"updatedAt":1312},"convex-create-component","build reusable Convex components","Builds reusable Convex components with isolated tables and app-facing APIs. Use for new components, reusable backend modules, integrations, or component boundary work.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1304,1307,1310,1311],{"name":1305,"slug":1306,"type":16},"API Development","api-development",{"name":1308,"slug":1309,"type":16},"Architecture","architecture",{"name":14,"slug":15,"type":16},{"name":9,"slug":8,"type":16},"2026-07-12T08:00:39.428577",{"slug":4,"name":4,"fn":5,"description":6,"org":1314,"tags":1315,"stars":24,"repoUrl":25,"updatedAt":26},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1316,1317,1318,1319],{"name":14,"slug":15,"type":16},{"name":9,"slug":8,"type":16},{"name":19,"slug":20,"type":16},{"name":22,"slug":23,"type":16},{"slug":1321,"name":1321,"fn":1322,"description":1323,"org":1324,"tags":1325,"stars":24,"repoUrl":25,"updatedAt":1336},"convex-performance-audit","audit Convex application performance","Audits Convex performance for reads, subscriptions, write contention, and function limits. Use for slow features, insights findings, OCC conflicts, or read amplification.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1326,1327,1330,1333],{"name":9,"slug":8,"type":16},{"name":1328,"slug":1329,"type":16},"Debugging","debugging",{"name":1331,"slug":1332,"type":16},"Monitoring","monitoring",{"name":1334,"slug":1335,"type":16},"Performance","performance","2026-07-12T08:00:50.02928",{"slug":1338,"name":1338,"fn":1339,"description":1340,"org":1341,"tags":1342,"stars":24,"repoUrl":25,"updatedAt":1353},"convex-quickstart","initialize Convex in applications","Creates or adds Convex to an app. Use for new Convex projects, npm create convex@latest, frontend setup, env vars, or the first npx convex dev run.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1343,1346,1347,1350],{"name":1344,"slug":1345,"type":16},"CLI","cli",{"name":9,"slug":8,"type":16},{"name":1348,"slug":1349,"type":16},"Frontend","frontend",{"name":1351,"slug":1352,"type":16},"Onboarding","onboarding","2026-07-12T08:00:43.436152",{"slug":1355,"name":1355,"fn":1356,"description":1357,"org":1358,"tags":1359,"stars":24,"repoUrl":25,"updatedAt":1368},"convex-setup-auth","set up authentication and access control","Sets up Convex auth, identity mapping, and access control. Use for login, auth providers, users tables, protected functions, or roles in a Convex app.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1360,1363,1366,1367],{"name":1361,"slug":1362,"type":16},"Access Control","access-control",{"name":1364,"slug":1365,"type":16},"Auth","auth",{"name":14,"slug":15,"type":16},{"name":9,"slug":8,"type":16},"2026-07-12T08:00:48.652641",{"slug":1370,"name":1370,"fn":1371,"description":1372,"org":1373,"tags":1374,"stars":253,"repoUrl":1380,"updatedAt":1381},"add","add capabilities to Convex applications","Add a capability to the CURRENT Convex + Next.js project — consults the served Convex capability catalog for always-current procedures (billing, crons, auth, agent, search, …); falls back to built-in hosting or @convex-dev component search. TRIGGER when the user runs $add, or asks to add hosting\u002Fpublishing or any backend capability to an existing Convex app.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1375,1376,1377],{"name":14,"slug":15,"type":16},{"name":9,"slug":8,"type":16},{"name":1378,"slug":1379,"type":16},"Next.js","next-js","https:\u002F\u002Fgithub.com\u002Fget-convex\u002Fconvex-codex-plugin","2026-07-12T07:59:59.358004",{"slug":1383,"name":1383,"fn":1384,"description":1385,"org":1386,"tags":1387,"stars":253,"repoUrl":1380,"updatedAt":1400},"agent","build AI agents with Convex","Build an AI agent \u002F RAG feature on Convex (@convex-dev\u002Fagent: threads, tools, vector search). TRIGGER on an AI-agent\u002Fchatbot\u002FRAG request.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1388,1391,1394,1397],{"name":1389,"slug":1390,"type":16},"Agents","agents",{"name":1392,"slug":1393,"type":16},"Engineering","engineering",{"name":1395,"slug":1396,"type":16},"RAG","rag",{"name":1398,"slug":1399,"type":16},"Search","search","2026-07-12T08:00:01.921824",{"slug":1365,"name":1365,"fn":1402,"description":1403,"org":1404,"tags":1405,"stars":253,"repoUrl":1380,"updatedAt":1414},"add authentication to Convex applications","Add sign-in (passkeys by default, OAuth\u002Fpassword optional) to the current Convex app, wired correctly incl. auth.config.ts. TRIGGER on a login\u002Fauth request for an existing app.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1406,1407,1410,1411],{"name":1364,"slug":1365,"type":16},{"name":1408,"slug":1409,"type":16},"Authentication","authentication",{"name":9,"slug":8,"type":16},{"name":1412,"slug":1413,"type":16},"OAuth","oauth","2026-07-18T05:12:54.443056",{"slug":1416,"name":1416,"fn":1417,"description":1418,"org":1419,"tags":1420,"stars":253,"repoUrl":1380,"updatedAt":1431},"billing","integrate Stripe billing in Convex apps","Add Stripe billing to a Convex app via @convex-dev\u002Fstripe (checkout + auto-verified webhook + subscription gating). TRIGGER on a payments\u002Fbilling\u002Fsubscription request.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1421,1422,1425,1428],{"name":9,"slug":8,"type":16},{"name":1423,"slug":1424,"type":16},"Payments","payments",{"name":1426,"slug":1427,"type":16},"Stripe","stripe",{"name":1429,"slug":1430,"type":16},"Webhooks","webhooks","2026-07-12T08:00:08.123246",{"slug":1433,"name":1433,"fn":1434,"description":1435,"org":1436,"tags":1437,"stars":253,"repoUrl":1380,"updatedAt":1445},"check-updates","upgrade Convex component versions","Check the CURRENT Convex app's pinned components against the latest recommended versions and offer to upgrade them — e.g. the passkey auth component's new email-first sign-in. TRIGGER when the user runs \u002Fcheck-updates or $check-updates, asks 'are my components up to date', 'any updates', 'upgrade auth', 'upgrade my components', or wants the newest features after a quickstart. Applies each upgrade behind a build gate (verify-or-revert) with the user's consent.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1438,1441,1442],{"name":1439,"slug":1440,"type":16},"Configuration","configuration",{"name":9,"slug":8,"type":16},{"name":1443,"slug":1444,"type":16},"Maintenance","maintenance","2026-07-12T08:00:03.236862",{"slug":1447,"name":1447,"fn":1448,"description":1449,"org":1450,"tags":1451,"stars":253,"repoUrl":1380,"updatedAt":1460},"convex-authz","audit and harden Convex authorization","Audit and harden a Convex app's authorization: identity-from-arg impersonation, missing per-document ownership checks, and public queries leaking PII\u002Ffinancial data by a client-supplied id — the single largest real-defect cluster measured against generated Convex backends (44 of 214). Runs a deterministic scan for the 3 shapes, then applies the canonical requireIdentity\u002FrequireOwner pattern, then verifies with tsc. TRIGGER on 'secure my app', 'audit auth', 'add login', 'who can access this data', or an explicit 'audit my authz'. NOT always-on. SKIP when there is no convex\u002F directory.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1452,1453,1456,1457],{"name":1364,"slug":1365,"type":16},{"name":1454,"slug":1455,"type":16},"Code Analysis","code-analysis",{"name":9,"slug":8,"type":16},{"name":1458,"slug":1459,"type":16},"Security","security","2026-07-12T08:00:04.516752",26,{"items":1463,"total":353},[1464,1470,1477,1484,1491,1498],{"slug":8,"name":8,"fn":1288,"description":1289,"org":1465,"tags":1466,"stars":24,"repoUrl":25,"updatedAt":1297},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1467,1468,1469],{"name":14,"slug":15,"type":16},{"name":9,"slug":8,"type":16},{"name":1295,"slug":1296,"type":16},{"slug":1299,"name":1299,"fn":1300,"description":1301,"org":1471,"tags":1472,"stars":24,"repoUrl":25,"updatedAt":1312},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1473,1474,1475,1476],{"name":1305,"slug":1306,"type":16},{"name":1308,"slug":1309,"type":16},{"name":14,"slug":15,"type":16},{"name":9,"slug":8,"type":16},{"slug":4,"name":4,"fn":5,"description":6,"org":1478,"tags":1479,"stars":24,"repoUrl":25,"updatedAt":26},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1480,1481,1482,1483],{"name":14,"slug":15,"type":16},{"name":9,"slug":8,"type":16},{"name":19,"slug":20,"type":16},{"name":22,"slug":23,"type":16},{"slug":1321,"name":1321,"fn":1322,"description":1323,"org":1485,"tags":1486,"stars":24,"repoUrl":25,"updatedAt":1336},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1487,1488,1489,1490],{"name":9,"slug":8,"type":16},{"name":1328,"slug":1329,"type":16},{"name":1331,"slug":1332,"type":16},{"name":1334,"slug":1335,"type":16},{"slug":1338,"name":1338,"fn":1339,"description":1340,"org":1492,"tags":1493,"stars":24,"repoUrl":25,"updatedAt":1353},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1494,1495,1496,1497],{"name":1344,"slug":1345,"type":16},{"name":9,"slug":8,"type":16},{"name":1348,"slug":1349,"type":16},{"name":1351,"slug":1352,"type":16},{"slug":1355,"name":1355,"fn":1356,"description":1357,"org":1499,"tags":1500,"stars":24,"repoUrl":25,"updatedAt":1368},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1501,1502,1503,1504],{"name":1361,"slug":1362,"type":16},{"name":1364,"slug":1365,"type":16},{"name":14,"slug":15,"type":16},{"name":9,"slug":8,"type":16}]