monorepo-next

monorepo-next

Detach monorepo packages from normal linking. Work on breaking changes while gradually updating consumers.

Each package can have a monorepo-next.config.js with the following options:

module.exports = {
  // Set this to false to opt-out of change detection and versioning.
  shouldBumpVersion: true,

  // If your package has a build step, your package.json/files array
  // will be a git-ignored dir, so we can't use that. Use this to
  // allow us to still find changes to your package. This appends
  // to your existing NPM tracked files.
  changeTrackingFiles: ['src/**'],
}

next [command]

Commands:
  next attach [package]            attach a package to a detached package to
                                   resume normal linking            [aliases: a]
  next changed-files [packages..]  list changed files
  next changed                     list changed packages
  next cycles                      detect circular references
  next defrag                      synchronize all dependency version
                                   discrepancies
  next detach [package]            detach a package from normal linking
                                                                    [aliases: d]
  next release                     release all packages as needed
  next run                         run script against changed packages

Options:
  --help     Show help                                                 [boolean]
  --version  Show version number                                       [boolean]

next attach [package]

attach a package to a detached package to resume normal linking

Options:
  --help     Show help                                                 [boolean]
  --version  Show version number                                       [boolean]

next changed-files [packages..]

list changed files

Options:
  --help                     Show help                                 [boolean]
  --version                  Show version number                       [boolean]
  --ext                      filter by extension                        [string]
  --only-include-releasable  If a file was changed that is not published, don't
                             count it towards a package change.
                                                      [boolean] [default: false]
  --exclude-dev-changes      If a change doesn't affect consumers, like a
                             monorepo dev dep change or manually bumping an
                             external dev dep, don't count it towards a package
                             change.                  [boolean] [default: false]
  --exclude-deleted          Excluded deleted files from the changeset.
                                                      [boolean] [default: false]

next changed

list changed packages

Options:
  --help                     Show help                                 [boolean]
  --version                  Show version number                       [boolean]
  --only-include-releasable  If a file was changed that is not published, don't
                             count it towards a package change.
                                                      [boolean] [default: false]
  --exclude-dev-changes      If a change doesn't affect consumers, like a
                             monorepo dev dep change or manually bumping an
                             external dev dep, don't count it towards a package
                             change.                  [boolean] [default: false]
  --exclude-deleted          Excluded deleted files from the changeset.
                                                      [boolean] [default: false]

next cycles

detect circular references

Options:
  --help                            Show help                          [boolean]
  --version                         Show version number                [boolean]
  --detect-dev-dependencies, --dev  alert when there is a devDependency in the
                                    loop              [boolean] [default: false]

next defrag

synchronize all dependency version discrepancies

Options:
  --help          Show help                                            [boolean]
  --version       Show version number                                  [boolean]
  --include       only synchronize a subset of dependencies[array] [default: []]
  --exclude       ignore a subset of dependencies          [array] [default: []]
  --out-of-range  override ranges that are out of range
                                   [string] [choices: "major", "minor", "patch"]
  --dry-run       log to console instead of modifying files
                                                      [boolean] [default: false]

next detach [package]

detach a package from normal linking

Options:
  --help     Show help                                                 [boolean]
  --version  Show version number                                       [boolean]

next release

release all packages as needed

Options:
  --help                            Show help                          [boolean]
  --version                         Show version number                [boolean]
  --silent                          Don't print logs and errors
                                                      [boolean] [default: false]
  --dry-run                         log to console instead of modifying files
                                                      [boolean] [default: false]
  --push                            git push + tags when done
                                                       [boolean] [default: true]
  --publish                         npm publish when done
                                                       [boolean] [default: true]
  --dist-tag                        publish to a different NPM dist-tag
                                                    [string] [default: "latest"]
  --bump-in-range-dependencies      If a dependency is still in range, and
                                    nothing changed in my package, still bump my
                                    version and the dependency version.
                                                       [boolean] [default: true]
  --inherit-greater-release-type    If a dependency has a greater release type,
                                    bump my package the with the same release
                                    type.             [boolean] [default: false]
  --exclude-dev-changes             If a change doesn't affect consumers, like a
                                    monorepo dev dep change or manually bumping
                                    an external dev dep, don't count it towards
                                    a package change. [boolean] [default: false]
  --validate-dependency-visibility  Prevent releasing public packages that
                                    depend on private packages.
                                                      [boolean] [default: false]
  --clean-up-after-failed-push      If there's already a new commit on the
                                    remote, clean up the commit and tags that
                                    won't be used     [boolean] [default: false]
  --scripts                         Provide scripts to execute for lifecycle
                                    events (prebump, precommit, etc.,)
                                                                   [default: {}]
  --package-files
                [array] [default: ["package.json","bower.json","manifest.json"]]
  --bump-files
  [array] [default: ["package.json","bower.json","manifest.json","package-lock.j
                                                    son","npm-shrinkwrap.json"]]
  --default-branch                                  [string] [default: "master"]

next run

run script against changed packages

Options:
  --help                     Show help                                 [boolean]
  --version                  Show version number                       [boolean]
  --only-include-releasable  If a file was changed that is not published, don't
                             count it towards a package change.
                                                      [boolean] [default: false]
  --exclude-dev-changes      If a change doesn't affect consumers, like a
                             monorepo dev dep change or manually bumping an
                             external dev dep, don't count it towards a package
                             change.                  [boolean] [default: false]
  --exclude-deleted          Excluded deleted files from the changeset.
                                                      [boolean] [default: false]
  --silent                   Don't print logs and errors
                                                      [boolean] [default: false]