A library of helper functions to do SemVer2 compliant releases from Conventional Commits in monorepos.
npm install @coveo/semantic-monorepo-tools
Before, one would use lerna version
to make semantic releases in a monorepo, but lerna is dead.
The most predominant tools in the field, standard-version
and semantic-release
do not offer the level of flexibility that lerna
did offer (e.g. it's hard to do semantic releases when packages do not share the same version and Changelog generation are sometimes tangled).
Because there are so many ways to do semantic releases in a monorepo, and that an opinionated way could result in releases that make less sense for the user of the published packages, semantic-monorepo-tools
took the approach to leave the implementation process in the hand of the user, and instead focus on providing functions to 'get what you need' and 'do what you need to do' directly with JavaScript.
semantic-monorepo-tools
aims to take the functions of a single-package release flow such as standard-version
and make them available as standalone building blocks.
The goal is to make abstractions of the inner working of the tools (e.g. git
, npm
) behind simple pure (ish) functions.
semantic-monorepo-tools
use itself for its release process, you can see the 'meat of it' here.
It is also used for the release processes of several monorepos at Coveo, you can find implementations examples on some of our repository: