Home

Awesome

monorepo-run

Run scripts in monorepo with colors, streaming and separated panes

<p align="center"> <img src="./mono-run.png" alt="Mono run screenshot"> </p>

Installation

yarn global add monorepo-run

Or locally in your project:

yarn add -D monorepo-run

Usage

Execute mono-run <script> to run a NPM script in your monorepo packages.

By default it will understand Yarn workspaces.

To display the command help, use:

mono-run --help

UI

Enable UI layouts with the --ui flag:

mono-run lint --ui row
<p align="center"> <img src="./mono-run-ui.png" alt="Mono run UI screenshot"> </p>

Streaming

By default, mono-run will wait for scripts to complete before displaying the outputs. If you want to get the output as soon as it's written instead, specify the --stream flag:

mono-run dev --stream

You can throttle the output so it's less overwelming in case there are a lot of writes:

# Throttle every 500ms
mono-run dev --stream 500

Examples

In your package.json:

{
  "scripts": {
    "dev": "mono-run dev --stream 500",
    "lint": "mono-run lint",
    "test": "mono-run test"
  }
}

Sponsors

sponsors logos