What it does

  • Automatic Version Detection

    Scans commits since the last tag and determines the appropriate semantic versioning bump based on Conventional Commits.

  • Git Tag Management

    Creates annotated tags, handles prefixes for monorepo versioning, and manages git references automatically.

  • Changelog Generation

    Produces markdown changelogs grouped by release, with commits categorized by type for clear release automation documentation.

  • Multi-Package Workspaces

    Independent versioning for monorepos with per-package configuration and coordinated release management.

  • CI-Friendly Output

    Text, JSON, and compact formats for scripting, CI/CD pipelines, and release automation workflows.

  • Hooks System

    Run custom scripts before and after releases for validation, builds, or deployment steps.

Commands

  • vump plan

    Preview release without changes

  • vump release

    Execute release interactively

  • vump release --yes

    Non-interactive for CI

  • vump changelog

    Generate changelog file

  • vump verify

    Validate configuration

  • vump init

    Create vump.toml

Commit types

Follows the Conventional Commits specification. Commit messages determine semantic version bumps:

major
feat!: or BREAKING CHANGE:
minor
feat:
patch
fix:, perf:, refactor: