# sequelize/umzug

Framework agnostic migration tool for Node.js

Repository: https://github.com/sequelize/umzug
Canonical: https://ross.abutalabs.com/products/umzug
Language: TypeScript
License: MIT
License Family: permissive
Topics: sequelize, javascript, typescript, migrations
Last push: 2026-08-26T11:52:34+00:00

## Health v2 (maintenance only)
Score: 82/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 49, longevity 100
- inputs: {"age_days": 4326, "days_push": 7, "days_rel": 124, "gap_med": 585, "n_releases_24m": 2}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2208, forks 162 (observed 2026-08-28T04:06:26.114072+00:00)

## What it is
Umzug is a framework-agnostic migration tool for Node.js that provides a clean programmatic and CLI API for running and rolling back migration tasks. It is database agnostic and supports multiple storages for tracking applied migrations, with Sequelize being the most commonly used.

## Use cases
- run database migrations in a node.js app
- roll back database schema changes
- manage migrations without being tied to an ORM
- run migrations programmatically from code
- write database migrations in TypeScript
- track applied migrations in a database table
- run migrations from the command line

## When to choose
- you need database migrations in a Node.js project with any ORM or database
- you want a programmatic migration API rather than only a CLI
- you use Sequelize and want first-class migration support
- you want to write migrations in TypeScript

## When to avoid
- you need migrations for a non-JavaScript stack
- you want a full ORM with built-in migration generation from models
- you need zero-config migrations for a specific framework that ships its own tooling

## Facets
- artifact type: library
- maturity: stable
- function: database, cli, developer-tools
- domain: databases, developer-tools, backend
- platform: cli, cross-platform
- tags: migrations, database-migrations, sequelize, typescript, schema-migration, nodejs

## Member repositories
- sequelize/umzug (main) score 82

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:26.114072+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:46:21.313397+00:00, confidence not recorded.
  - readme: https://github.com/sequelize/umzug (fetched 2026-08-28T04:06:26.114072+00:00, sha cd068bc1f134)
  - registry_npm: https://registry.npmjs.org/umzug (fetched 2026-08-29T10:27:01.718261+00:00, sha fa7d3c4f1d98)
- Data as of 2026-08-30T08:39:29.467469+00:00.