@xcritical/boltify

Boltify

A tool for managing projects with multiple packages based on Bolt.

What are workspaces?

A workspace is like any other node package: It's just a directory with its own package.json.

Workspaces are grouped into a single "project". A project is also just a node package at the root of your repository. This is sometimes referred to as a "monorepo", but we prefer the term "multi-package repo".

project
├── package.json
├── workspace-one
│   ├── package.json
│   └── index.js
└── workspace-two
    ├── package.json
    └── index.js

Put another way, workspaces are just like any other package, except they are nested within a larger project/repo. Each workspace can have its own code and scripts. Workspaces can also be grouped into sub-directories for further organization.

Note: This idea is not new, other tools like Lerna have existed for awhile and are used by many projects. Boltify is a fresh take on the idea.

Commands

Note: Boltify is under active development and some of these commands have not yet been implemented.

Command	Description	Status
boltify version	Updates the version of your package(s)	✅
└ boltify version --only [name glob]	Filter package(s) by name	✅
└ boltify version --ignore [name glob]	Filter out package(s) by name	✅
└ boltify version --only-fs [file glob]	Filter package(s) by file path	✅
└ boltify version --ignore-fs [file glob]	Filter out package(s) by file path	✅
└ boltify version --no-git-tag-version	New tag(s) will not be added and pushed	✅
└ boltify version --no-push	New tag(s) will not be pushed	✅
boltify run [script]	Run a script in a package	✅
└ boltify run --only [name glob]	Filter package(s) by name	✅
└ boltify run --ignore [name glob]	Filter out package(s) by name	✅
└ boltify run --only-fs [file glob]	Filter package(s) by file path	✅
└ boltify run --ignore-fs [file glob]	Filter out package(s) by file path	✅
└ boltify run --since ref	Filter package(s) that have been updated since the specified ref	✅
boltify workspaces/ws	Show package(s):
└ boltify ws --only [name glob]	Filter package(s) by name	✅
└ boltify ws --ignore [name glob]	Filter out package(s) by name	✅
└ boltify ws --only-fs [file glob]	Filter package(s) by file path	✅
└ boltify ws --ignore-fs [file glob]	Filter out package(s) by file path	✅
└ boltify ws --since ref	Filter package(s) that have been updated since the specified ref	✅