bru

Bru 🤵 helps you manage monorepos.

Try it out, it's lekker bru!

• Usage
• Commands
• Hooks

Usage

$ npm install -g bru

$ bru COMMAND
running command...

$ bru (-v|--version|version)
bru/1.0.0

$ bru --help [COMMAND]
USAGE
  $ bru COMMAND

...

Commands

• bru add <package> [versionOrTag]
• bru bump <package> <type>
• bru set <package> <versionOrTag>
• bru get [package]
• bru remove <package>
• bru check [package]

bru add <package> [versionOrTag]

Adds a new package to the root (by default) or a specific local package

USAGE
  $  bru add <package> [versionOrTag]

OPTIONS
  -h, --help            show CLI help
  -D, --save-dev        as dev dependency
  -R, --root            saves in root dir (default)
  -P, --package <name>  saves in a package

bru set <package> <versionOrTag>

Sets a new version of a package (specific or based on provided dist tag)

USAGE
  $  bru set <package> <versionOrTag>

OPTIONS
  -h, --help            show CLI help

bru get <package>

Displays a version of a package

USAGE
  $  bru get <package>

OPTIONS
  -h, --help            show CLI help

bru remove <package>

Removes a package

USAGE
  $  bru remove <package>

OPTIONS
  -h, --help            show CLI help
  -R, --root            removes from root dir (default)
  -P, --package <name>  removes from a package

bru bump <package> <type>

Bumps a version of a package.

Available types:

• major
• premajor
• minor
• preminor
• patch
• prepatch
• prerelease

USAGE
  $  bru bump <package> <type>

OPTIONS
  -f, --force
  -h, --help            show CLI help

bru check [package]

Checks if every package (or specific one) is in the same version across entire project.

USAGE
  $  bru check [package]

OPTIONS
  -h, --help            show CLI help

Hooks

Bru allows to hook into changes in monorepo.

{
  "config": {
    "bru": {
      "hook": "./bru-events.js"
    }
  }
}

/**
 * event: {
 *   type: string;
 *   data: any
 * }
 */
module.exports = function(event) {
  switch (event.type) {
    case 'version':
      console.log('Version changed', event.data);
      break;
    case 'add':
      console.log('Dependency added', event.data);
      break;
    case 'remove':
      console.log('Dependency removed', event.data);
      break;
  }
};