mcpField
C
convex-seed

convex-seed

github.com/convexData & databases6936.9k installsUpdated 1d ago
Repository

About convex-seed

convex-seed is a skill for populating Convex tables with fixture data or bulk imports. It guides developers through schema-matched, repeatable seeding and row-count verification.

Key features

  1. 01Seed fixtures with an internalMutation
  2. 02Import bulk data with npx convex import
  3. 03Make seeding idempotent
  4. 04Verify row counts

Use cases

  1. 01Populate tables for development or tests
  2. 02Import data shaped to a Convex schema
  3. 03Rerun a seed operation safely

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/convex/agent-skills --skill convex-seed

After installing, type/convex-seedin Claude Code to confirm it loaded.

Details

From the project README

Seed / import data

Populate tables via an internalMutation seed function (re-runnable) or npx convex import, matching the schema.

Workflow

  1. For fixtures: write an internalMutation that inserts sample rows; run it with npx convex run.
  2. For bulk import: shape the data to the schema and use npx convex import.
  3. Make seeding idempotent (clear-then-insert or upsert) so re-running is safe.
  4. Verify row counts.

Rules

  • Seed via internalMutation or convex import, matching validators.
  • Make seeding idempotent.
  • Never seed secrets/PII into a shared deployment.

Comments

Markdown supported