Seed / import data
Populate tables via an internalMutation seed function (re-runnable) or npx convex import, matching the schema.
Workflow
- For fixtures: write an internalMutation that inserts sample rows; run it with
npx convex run. - For bulk import: shape the data to the schema and use
npx convex import. - Make seeding idempotent (clear-then-insert or upsert) so re-running is safe.
- Verify row counts.
Rules
- Seed via internalMutation or convex import, matching validators.
- Make seeding idempotent.
- Never seed secrets/PII into a shared deployment.