@nomadland/mono


Monorepo development & continuous integration tooling.

Motivation

When we released _monorepo_, a headache problem was that release flow failed but some packages had been published to NPM. At this time, you may discard current release, or publish manually one by one, but it's quite troublesome in a monorepo with a large number of packages.

mono introduced a post patch process, it helps you to continue current release with visible release status.


Features

- Restartable release flow, powered by a post patch release process with visible release status.
- Quickly launch on-demand development build for monorepo.
- Generated changelog with author.

Table of Contents

- Install
- Usage
- A complete release workflow
- Execute build after bump version
- Independent patch process
- Generate Changelog
- Attach commit author
- Create commit
- Auto push
- On-demand development build
- Commands
- mono release
- mono patch
- mono changelog
- mono dev
- Projects using MONO
- FAQ
- Author

Install

``bash
npm i -g @nomadland/mono # globally
npm i -D @nomadland/mono # as devDependencies
`

Usage

$3

If you had a monorepo as:

`bash
.
├── lerna.json
├── package.json
└── packages
   ├── foo
   ├── bar
   ├── baz
   └── qux
`

If current version is 2.1.1, after a period of time, I decide to release a patch version with latest version, so I execute:

`bash
mono release
`

You'll receive a prompt log to choose a release version, and you selected 2.1.2 to continue.

If release process got failed, you'll see a _visible release status_ under patch stage:





Just select Y to finish release for all unpublished packages.

$3

You may execute mono release after build packages, but if your build process generated assets that contains the version of each, you'll get a wrong version at final NPM assets, you can execute build after version is bumped:

`bash
mono release --build --ignore-scripts


Note that --ignore-scripts is required if you set prepublishOnly for sub packages.


`

$3

Patch process has been integrated into release flow, you can also use it separately:

`bash
mono patch --tag=latest # launch patch process with latest tag.
`

$3

Changelog process has been integrated into release flow, You can also use it separately:

`bash
mono changelog # generate changelog
`

The equivalent command under release flow is:

`
mono changelog --beautify --commit --gitPush --attachAuthor --authorNameType name
`

#### Attach commit author

`bash
mono changelog --attachAuthor
`

Commits under generated changelog will be attached with commit author:

`diff
### Bug Fixes

-* scope: xx (d1cfea5)
+* scope: xx (d1cfea5) @ULIVZ
`

#### Create commit

`bash
mono changelog --commit
`

mono will create a commit for generated changelog.

#### Auto push

`bash
mono changelog --gitPush
`

mono will create a push action to remote repository.

$3

using lerna run dev will launch all dev process for all packages, using mono dev will launch a on-demand development build for monorepo.

`bash
mono dev
`

Commands

$3

Using mono release to replace lerna publish:

`bash
mono release # standard release flow
mono release --no-changelog # do not generate changelog
mono release --ignore-scripts # ignore npm scripts under release process.
mono release --dry-run # preview execution
`

$3

`bash
mono patch --tag laest # standard release flow
mono patch --tag next # launch patch process with next tag.
mono patch --tag latest --ignore-scripts # Ignore npm scripts under patch process.
`

$3

`bash
mono changelog
mono changelog --beautify # beautify changelog
mono changelog --commit # create a commit
mono changelog --gitPush # push to remote repository
mono changelog --attachAuthor # add author to generated changelog
mono changelog --authorNameType email # set display author to author's email
mono changelog --authorNameType name # set display author to author's name
`

Recommended composable flags:

`bash
mono changelog --beautify --commit --gitPush --attachAuthor --authorNameType name
`

$3

`bash
mono dev # launch a on-demand development build for monorepo.
``

Projects Using MONO

Projects that use MONO:

- VuePress: 📝 Minimalistic Vue-powered static site generator.
- Many ByteDance projects.
- Feel free to add yours here...

FAQ

$3

mono leverage lerna under the hood, but you can still use it in other monorepo tool chains, such as rush.

Author

MIT © ULIVZ