@jacob-ebey/mono-build

MONO Build

A simple build tool for mono-repos that takes care of installing and linking packages.

Why MONO Build?

It's SIMPLE.

• A single install for all packages
• Keep dependencies in sync
• Simply define a package build order
• Keep each project buildable on it's own

Getting Started

• Add "@jacob-ebey/mono-build" to the root package.json as a devDependency
• Add a mono.json file alongside the root package.json

Configure mono.json:

{
  "packages": [
    {
      "name": "package-a",
      "path": "packages/package-a" 
    },
    {
      "name": "package-b",
      "path": "packages/package-b" 
    }
  ]
}

Note that the build order is defined by the order of the packages in mono.json.

Commands

• mono-build - Runs the build script for each project in order
• mono-build install - Install packages and link to projects
• mono-build link - Link packages to projects (should only need to run if you have ran unlink)
• mono-build unlink - Unlink packages from projects
• mono-build <SCRIPT> - Run the provided script in each project
• mono-build --parallel <SCRIPT> - Run the provided script in each project in parallel (good for things like webpack-dev-server or subsequent builds)