Postgres seeding, one place, any ORM

Seed your Postgres database with the ORM you already use.

A lightweight, zero-dependency seeder toolkit for Postgres. Track one-time seed scripts, run them on startup, and manage them from a small CLI. Works with Prisma, Drizzle, TypeORM, and Sequelize.

npm install pg-seed-kit

Zero runtime dependencies ESM + CommonJS TypeScript-first

Choose your ORM

Configure

Point pg-seed-kit at your seeders and tell it how to connect. pg-seed-kit.config.js

Write a seeder

Scaffold one with npx pg-seed-kit create add-admin, then use your ORM as usual. Keep it idempotent.

Run

From your app after the ORM connects, or with npx pg-seed-kit run.

How it works

Seeder files are sorted by their timestamp prefix, so they run in order.
Each run executes only seeders without a success record. The tracking table (seeders) is created automatically.
A failed seeder is recorded and retried next run; the others keep going.

CLI

npx pg-seed-kit create <name>    # Scaffold a new seeder file
npx pg-seed-kit status           # List seeders and statuses
npx pg-seed-kit run              # Run all pending seeders
npx pg-seed-kit run <name>       # Force-run one seeder by name
npx pg-seed-kit reset <name>     # Mark a seeder as pending

API & options

Function	Description
`runPendingSeeders(options?)`	Runs seeders without a successful tracking record.
`runSeederByName(name, options?)`	Force-runs one seeder, even if already executed.
`getSeederStatuses(options?)`	Lists pending, success, and failed seeders.
`resetSeeder(name, options?)`	Deletes the tracking record so a seeder can rerun.

Option	Type	Default	Description
`seedersPath`	`string \| () => string`	required	Directory of seeder files.
`tableName`	`string`	`"seeders"`	Tracking table name.
`adapter`	`Adapter`	none	Live adapter for calling the API from your app.
`connect`	`() => Promise<Adapter>`	none	Used by the CLI to open a connection.