Understanding semver versioning for your nodejs packages

Semver is the standard way of updating the versions of your package in nodejs. After reading through the original article, I decided to put together a quick visual summary of it. Since its just a summary, it won’t cover all of the topics, but its enough help you quickly wrap your head around it.

The diagram below shows the different parts of a semver version number.

parts of semver


When creating a package

PATCH Version Number

  • Starts from 1
  • Increments by 1 when you fix bugs but dont introduce new features.

MINOR Version Number

  • Starts from 0.
  • Indicates a backward compatible new feature.
  • An increment resets the patch number to 0 on each increment.

MAJOR Version Number

  • Starts from 0
  • Incremented only when a backwards incompatible feature is introduced.
  • An increments resets both – Minor and Patch version numbers to 0.

When consuming a package

The diagram below shows the three most important ways in which you consume a package that is versioned using semver.

parts of semver


Ryan Sukale

Ryan is just a regular guy next door trying to manage his life and finances.

Show Buttons
Hide Buttons