lerna

What is lerna?

Lerna is a tool that optimizes the workflow around managing multi-package repositories with git and npm. It allows you to manage your project's dependencies, versioning, and publishing in a more organized manner, especially when dealing with a monorepo containing multiple packages.

What are lerna's main functionalities?

Bootstrap

Installs all of the dependencies for each package, links any cross-dependencies, and ensures that each package can find and use the correct versions of each other.

lerna bootstrap

Publish

Helps with versioning of the changes and publishing packages that have been updated to npm. It can automatically determine version bumps based on conventional commits, create git tags, and push releases to the repository.

lerna publish

Run

Runs an npm script in each package that contains that script. The '--scope' flag can be used to run the script only in specified packages.

lerna run --scope my-package test

Exec

Executes an arbitrary command in each of your packages. In this example, it removes the 'node_modules' directory from each package.

lerna exec -- rm -rf ./node_modules

List

Lists all of the public packages in the current Lerna repo.

lerna list

Changed

Lists public packages that have changed since the last tagged release.

lerna changed

Diff

Shows the diff since the last release for a single package or all packages.

lerna diff

Import

Imports an external repository into the 'packages' folder of your Lerna monorepo, preserving the commit history.

lerna import <path-to-external-repository>

Other packages similar to lerna

nx

Nx is a suite of powerful, extensible dev tools that help you develop, test, build, and scale Angular and React applications with fully integrated support for monorepo management. It provides a more integrated experience for building applications compared to Lerna, which is more focused on package management.

README

Lerna is a fast, modern build system for managing and publishing multiple JavaScript/TypeScript packages from the same repository.

Usage

Check out our docs site here.

Changelog

7.0.0-alpha.0 (2023-05-10)

Features

• core: convert commands to use nx project graph instead of legacy package graph (#3667) (8e813c4)
• do not include bootstrap, add, link commands by default (#3658) (487d475)

BREAKING CHANGES

• We no longer include the bootstrap, add, and link commands by default. We strongly recommend using your package manager (npm, yarn, pnpm) for package management related concerns such as installing and linking dependencies.

If you want to temporarily continue to use those commands in v7 you can do so by installing the @lerna/legacy-package-management package at the same version as your lerna version.

There will not be any active work done on these commands and you should look to migrate as soon as possible, please check out https://lerna.js.org for further guidance.