Visit Apps Ved →

standard-version

Automated semantic versioning from commits

TLDR

Release new version
$ standard-version
First release
$ standard-version --first-release
Pre-release version
$ standard-version --prerelease alpha
Dry run
$ standard-version --dry-run
Specific version bump
$ standard-version --release-as [major|minor|patch]
Skip changelog
$ standard-version --skip.changelog

SYNOPSIS

standard-version [--release-as type] [--prerelease tag] [options]

DESCRIPTION

standard-version automates semantic versioning and changelog generation for Node.js projects based on the Conventional Commits specification. It analyzes commit messages (feat, fix, BREAKING CHANGE) to determine whether to bump the major, minor, or patch version.The tool updates the version in package.json, generates or updates a CHANGELOG.md from commit messages, creates a git commit with the version bump, and tags it with the new version number. A dry run mode previews changes without modifying files. Pre-release tags (alpha, beta, rc) are supported for staged releases.

PARAMETERS

--first-release

First version.
--release-as TYPE
Version bump type.
--prerelease TAG
Pre-release tag.
--dry-run
Preview only.
--skip.changelog
Skip changelog.
-s, --sign
Sign commits and tags with GPG.
-a, --commit-all
Commit all staged files, not just package/changelog.
-t, --tag-prefix prefix
Customize tag prefix (default: v).
--no-verify
Bypass pre-commit/commit-msg git hooks.

INSTALL

brew install standard

CAVEATS

Deprecated - the project is no longer maintained. The authors recommend release-please (GitHub users) or the fork commit-and-tag-version for continued support. Requires conventional commits, a Node.js project, and a git repository.

HISTORY

standard-version was created for automated semantic versioning based on Conventional Commits specification.

SEE ALSO

npm-version(1), semantic-release(1), git(1)