mongo-migrate-kitElegant MongoDB migrations for Node.js

Precise, safe migrations for MongoDB. Run a single file, roll back anything, and preview every change before it touches your database.

Run a single file

mmk up and mmk down — not just "all pending" or "the last batch". Full control over exactly what runs.

mmk up

Revert any batch (--batch 3), the last N migrations (--steps 2), a single file, or redo in one step — history is never deleted.

mmk down

mmk dry-run up shows precisely what would run before anything touches the database. No surprises in production.

mmk dry-run

An atomic MongoDB lock with a renewal heartbeat stops two deploys racing, and SHA-256 checksums catch edited migrations before they re-run.

Locking & unlock

Wrap a migration in a MongoDB transaction with export const useTransaction = true — automatic commit on success, abort on error.

Transactions

beforeAll, afterAll, beforeEach, afterEach, and onError — plug in logging, metrics, or notifications around every run.

Lifecycle hooks

Every run records duration, checksum, environment, user, and batch in an append-only changelog. A rollback updates the record, never removes it.

mmk status

.ts (native on Node 22.18+, or via a loader like tsx), ESM, and CommonJS all just work, with a fully-typed context and config.

Writing migrations

mmk import brings an existing migrate-mongo changelog forward as-is — no re-running, no data loss, no rewriting files.

Migrate from migrate-mongo