Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

@erquhart/lerna-project

lerna16MIT3.14.0

Lerna project configuration

lerna, core

readme

@lerna/project

Lerna project configuration

Configuration Resolution

Lerna's file-based configuration is located in lerna.json or the lerna property of package.json. Wherever this configuration is found is considered the "root" of the lerna-managed multi-package repository. A minimum-viable configuration only needs a version property; the following examples are equivalent:

{
  "version": "1.2.3"
}
{
  "name": "my-monorepo",
  "version": "0.0.0-root",
  "private": true,
  "lerna": {
    "version": "1.2.3"
  }
}

Any other properties on this configuration object will be used as defaults for CLI options of all lerna subcommands. That is to say, CLI options always override values found in configuration files (a standard practice for CLI applications).

Command-Specific Configuration

To focus configuration on a particular subcommand, use the command subtree. Each subproperty of command corresponds to a lerna subcommand (publish, create, run, exec, etc).

{
  "version": "1.2.3",
  "command": {
    "publish": {
      "loglevel": "verbose"
    }
  },
  "loglevel": "success"
}

In the example above, lerna publish will act as if --loglevel verbose was passed. All other subcommands will receive the equivalent of --loglevel success (much much quieter).

changelog

Change Log

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

3.14.0 (2019-03-21)

Note: Version bump only for package @erquhart/lerna-project

3.13.1 (2019-02-26)

Bug Fixes

  • deps: cosmiconfig ^5.1.0 (ed48950)

3.13.0 (2019-02-15)

Features

  • meta: Add repository.directory field to package.json (aec5023)
  • meta: Normalize package.json homepage field (abeb4dc)

3.11.0 (2019-02-08)

Bug Fixes

  • deps: Explicit npmlog ^4.1.2 (571c2e2)
  • deps: Remove unused libnpm (replaced by direct sub-packages) (1caeb28)

3.10.0 (2019-01-08)

Note: Version bump only for package @lerna/project

3.8.5 (2019-01-05)

Bug Fixes

  • project: Deprecate root-level config keys as well, prioritizing nested (7a65a87)
  • publish: Deprecate --npm-tag, replaced by --dist-tag (196d663)

3.7.2 (2018-12-21)

Note: Version bump only for package @lerna/project

3.7.0 (2018-12-19)

Note: Version bump only for package @lerna/project

3.6.0 (2018-12-07)

Features

3.5.0 (2018-11-27)

Bug Fixes

  • Update yarn workspaces error prompt link (#1756) (d6e6a42)

3.0.0 (2018-08-10)

Features

BREAKING CHANGES

    • --preid now defaults to "alpha" during prereleases:

    The previous default for this option was undefined, which led to an awkward "1.0.1-0" result when passed to semver.inc().

    The new default "alpha" yields a much more useful "1.0.1-alpha.0" result. Any previous prerelease ID will be preserved, just as it was before.

  • --no-verify is no longer passed to git commit by default, but controlled by the new --commit-hooks option:

    The previous behavior was too overzealous, and the new option operates exactly like the corresponding npm version option of the same name.

    As long as your pre-commit hooks are properly scoped to ignore changes in package.json files, this change should not affect you. If that is not the case, you may pass --no-commit-hooks to restore the previous behavior.

3.0.0-rc.0 (2018-07-27)

Bug Fixes

  • project: Report syntax errors in root package.json (f674f35), closes #1452

Features

  • project: Move collect-packages into getPackages() method (06b88d4)

3.0.0-beta.20 (2018-05-07)

Features

  • project: Upgrade cosmiconfig (9acde7d)

3.0.0-beta.19 (2018-05-03)

Features

  • project: Map deprecated config to new namespaces (4da6318)

3.0.0-beta.17 (2018-04-13)

Note: Version bump only for package @lerna/project

3.0.0-beta.15 (2018-04-09)

Bug Fixes

  • project: Pin --exact require-from-string v2.0.1 to avoid integrity error with v2.0.2 (32a38ad)

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

Features

  • package: Add Map-like get/set methods, remove raw json getter (707d1f0)
  • project: Merge package and packageJson into manifest (9a47ff7)

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.

3.0.0-beta.11 (2018-03-29)

Note: Version bump only for package @lerna/project

3.0.0-beta.10 (2018-03-27)

Features

  • project: Inherit configuration with yargs-like "extends" (0b28ef5), closes #1281

3.0.0-beta.9 (2018-03-24)

Features

  • project: Normalize config.commands -> config.command (24e55e3)
  • project: Use cosmiconfig to locate and read lerna.json (b8c2789)

3.0.0-beta.1 (2018-03-09)

Bug Fixes

  • publish: default root manifest name when missing (a504d7e), closes #1305