migronautElegant MongoDB migrations for Node.js

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

Get Started

Why migronaut?

View on GitHub

📭

Zero dependencies

No runtime dependencies at all — only the mongodb driver as a peer. Nothing extra in your lockfile, and no third-party code in the process that writes to your database.

How it got there

🎯

Run a single file

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

migronaut up

↩️

Real rollbacks

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

migronaut down

👀

Dry-run previews

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

migronaut dry-run

🔒

Safe by default

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

🔐

Opt-in transactions

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

Transactions

🪝

Lifecycle hooks

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

Lifecycle hooks

🧾

Audit-ready history

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

migronaut status

📘

TypeScript & JavaScript

.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

📦

Adopt migrate-mongo

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

Migrate from migrate-mongo