Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/azu/monorepo-utils

A collection of utilities for monorepo/lerna. Tools for TypeScript project references etc..
https://github.com/azu/monorepo-utils

javascript lerna monorepo npm typescript yarn

Last synced: 7 days ago
JSON representation

A collection of utilities for monorepo/lerna. Tools for TypeScript project references etc..

Lists

README

        

# monorepo-utils [![Actions Status: test](https://github.com/azu/monorepo-utils/workflows/test/badge.svg)](https://github.com/azu/monorepo-utils/actions?query=workflow%3A"test")

This repository is utilities for monorepo.
Also, this repository is a monorepo.

## Packages

### [@monorepo-utils/package-utils](./packages/@monorepo-utils/package-utils)

Collect package file path in the monorepo.

Supports following package manager's workspaces.

- Lerna(`lerna.json`)
- Yarn's workspaces
- npm v7+'s workspaces

### [@monorepo-utils/workspaces-to-typescript-project-references](./packages/@monorepo-utils/workspaces-to-typescript-project-references)

This tool converts lerna/npm workspaces/yarn workspaces to [TypeScript's Project References](https://www.typescriptlang.org/docs/handbook/project-references.html).

You can keep package dependencies synchronized between lerna/npm/yarn workspaces and TypeScript.

### [@monorepo-utils/collect-changelog](./packages/@monorepo-utils/collect-changelog)

[@monorepo-utils/collect-changelog](./packages/@monorepo-utils/collect-changelog) get change from each package's `CHANGELOG.md`.
It help to collect changelog in lerna's [Independent mode](https://github.com/lerna/lerna#independent-mode---independent).

### [@monorepo-utils/get-workspaces-cli](./packages/@monorepo-utils/get-workspaces-cli)

[@monorepo-utils/get-workspaces-cli](./packages/@monorepo-utils/get-workspaces-cli) is a simple CLI for getting workspace list.
It allows get file path of packages.

```shell
$ npx @monorepo-utils/get-workspaces-cli
```

## Deprecated Packages

### **Deprecated** [@monorepo-utils/publish](./packages/@monorepo-utils/publish)

[@monorepo-utils/publish](./archives/publish) help npm publish.

This script split `lerna publish`(lerna 2) into versioning and publishing.

:warning: Notes:

lerna 3 support `lerna version` and `lerna publish`.
You should use lerna 3 directly.

## Release Flow

1. Create Release PR via dispatching "Create Release" action
2. Review and Merge release PR
3. Published

See also:

- [azu/monorepo-github-releases: monorepo release flow: lerna + GitHub Release's Automatically generated release notes](https://github.com/azu/monorepo-github-releases)