Tool for managing JavaScript projects with multiple packages.
While developing Babel I developed a monorepo approach where the entire project was split into individual packages but lived in the same repo. This was great. It allowed super easy modularisation which meant the core was easier to approach and meant others could use the useful parts of Babel in their applications.
This tool was abstracted out of that and deals with bootstrapping these modules by linking them together as well as publishing them to npm. You can see the Babel repo for an example of a large Lerna project.
$ npm install -g lerna
$ lerna bootstrap
This will create a dummy VERSION
file as well as a packages
folder.
$ lerna bootstrap
- Link together all packages that depend on each other.
npm install
all other dependencies of each package.
$ lerna publish
- Publishes each module in
packages
that has been updated since the last version to npm with the tagprerelease
. - Once all packages have been published. Remove the
prerelease
tags and add the tagslatest
andstable
.
Lerna projects operate on a single version line. The version is kept in the file VERSION
at the root of your project. When you run lerna publish
, if a module has been updated
since the last time a release was made, it will be updated to the new version you're
releasing. This means that you only publish a new version of a package when you need to.