mcpField
C
convex-seed

convex-seed

github.com/get-convexData & databases6931.1k installsUpdated 1d ago
Repository

About convex-seed

convex-seed is a skill for populating or importing data into Convex tables, aimed at developers preparing fixtures or bulk data. It uses internalMutation or npx convex import, with schema-matched and repeatable seeding.

Key features

  1. 01Insert sample rows with internalMutation
  2. 02Bulk import with npx convex import
  3. 03Shape data to match the schema
  4. 04Make repeated seeding idempotent
  5. 05Verify row counts

Use cases

  1. 01Populate sample data for development or tests
  2. 02Bulk import data shaped for a table schema
  3. 03Rerun a seed operation safely

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/get-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