@lerna/bootstrap

What is @lerna/bootstrap?

@lerna/bootstrap is a part of the Lerna monorepo management toolset. It is used to install and link dependencies for a multi-package repository, ensuring that all inter-package dependencies are properly resolved and symlinked.

What are @lerna/bootstrap's main functionalities?

Install dependencies

This feature installs all the dependencies for the packages in the monorepo. It uses the npm client and hoists common dependencies to the root node_modules directory.

const { bootstrap } = require('@lerna/bootstrap');

bootstrap({
  cwd: process.cwd(),
  npmClient: 'npm',
  hoist: true
}).then(() => {
  console.log('Dependencies installed and linked');
});

Link local packages

This feature links local packages together, ensuring that inter-package dependencies are resolved using symlinks. This is useful for development as changes in one package are immediately reflected in dependent packages.

const { bootstrap } = require('@lerna/bootstrap');

bootstrap({
  cwd: process.cwd(),
  npmClient: 'npm',
  hoist: true
}).then(() => {
  console.log('Local packages linked');
});

Run lifecycle scripts

This feature runs specified lifecycle scripts (e.g., prepublish, postinstall) for all packages in the monorepo. This ensures that any necessary build steps or other setup tasks are performed.

const { bootstrap } = require('@lerna/bootstrap');

bootstrap({
  cwd: process.cwd(),
  npmClient: 'npm',
  hoist: true,
  scripts: ['prepublish', 'postinstall']
}).then(() => {
  console.log('Lifecycle scripts executed');
});

Other packages similar to @lerna/bootstrap

yarn

Yarn is a package manager that also supports monorepos through its workspaces feature. It installs dependencies and links local packages similarly to @lerna/bootstrap, but it is a more general-purpose tool with a broader scope.

pnpm

pnpm is a fast, disk space-efficient package manager that also supports monorepos. It uses a content-addressable file system to store all files from all module directories on a disk. It is similar to @lerna/bootstrap in that it can install and link dependencies, but it offers additional performance benefits.

rush

Rush is a monorepo management tool that provides sophisticated support for managing large repositories with many packages. It includes features for installing dependencies, linking local packages, and running lifecycle scripts, similar to @lerna/bootstrap, but it also offers advanced features like incremental builds and change tracking.

README

@lerna/bootstrap

description TODO

Usage

TODO

Changelog

3.0.0-beta.12 (2018-03-30)

Bug Fixes

• create: Silently ignore missing builtin npmrc (1523520), closes #1353
• npm-conf: Replace env vars even in config keys (3c9a5de)

Features

• package: Add serialize() method (fdec3ac)
• package: Add Map-like get/set methods, remove raw json getter (707d1f0)
• project: Merge package and packageJson into manifest (9a47ff7)
• Add --no-prefix for streaming output (#1352) (36c1fad)

BREAKING CHANGES

• package: The Package class no longer provides direct access to the JSON object used to construct the instance. Map-like get()/set(val) methods are available to modify the internal representation.

<a name="3.0.0-beta.11"></a>