Skip to main content

2026-05-20 · 1 min read

Semver bump before release

Patch for fixes, minor for features, major for breaking changes—write it down in the changelog.

semverreleasedevtools

Key takeaways

  • Compare two tags in the secondary field before you bump.
  • Major bumps need migration notes—even for internal libraries.

When to bump what

Patch: safe fixes. Minor: backward-compatible features. Major: breaking API or schema changes.

Record the chosen level in CHANGELOG before you tag.

FAQ

Do pre-release suffixes bump automatically?

The tool preserves -alpha/-beta suffixes on bump; verify manually.

What about calendar versioning?

Semver tools target MAJOR.MINOR.PATCH—use a different doc for CalVer.