:sailboat: Monorepo Release

Node functions that automate the independent versioning and publishing of packages in a monorepo.

Requires commit messages in the following format:

<type>(<scope>): <subject>

<scope> should be the name of the package intended to be released. The commit message format follows the angular commit message guidelines.

Note: for <scope> don't include the @scope/ prefix of the package (only the package name).

Commit message example

feat(package-a): add stuff to package-a

Commit message CLI

A commit message CLI builder like cz-customisable can be included in your project to ensure commit messages are always formatted correctly.

Changelogs

Changelogs can be generated with something like auto-changelog by setting the changelog command run for each package

Install auto-changelog in project

yarn add --dev auto-changelog

packages/package-a/package.json

"scripts": {
  "changelog": "auto-changelog"
},
"auto-changelog": {
  "output": "CHANGELOG.md",
  "tagPattern": "@scope/package-a@"
}

scripts/release.js

const { getPackages, release } = require('monorepo-release');
const packages = getPackages();

const config = {
  changelog: true,
  changelogCmd: 'yarn changelog',
};

packages.forEach(release(config));

Run script locally or in CI

node scripts/release.js

Requires initial package git tags to exist before release can be used to automate publishing

@scope/[email protected]
@scope/[email protected]

Generate tags manually or run a function available in this package to generate initial tags across current packages

Create initial tags: scripst/createTags.js

const { createTag, getPackages } = require('monorepo-release');
const packages = getPackages();

packages.forEach(createTag());

Run script

node scripts/createTags.js

Release: scripts/release.js

const { getPackages, release } = require('monorepo-release');
const packages = getPackages();

const config = {
  dryRun: true,
};

packages.forEach(release(config));

Config options and defaults

Run script locally or in CI

node scripts/release.js