monobuild

Smart CLI utility to rebuild projects inside a monorepo based on dependency graph and change detection.

✨ Features

• 🧠 Automatically detects monorepo type (Nx, Angular CLI, Yarn workspaces, etc.)
• 📦 Determines the build order from project dependencies
• ⚡ Rebuilds only what changed (based on timestamp cache)
• 🔨 Supports custom or default build commands per project type
• 🧪 Supports --self-only, --exclude, --force, and --verbose modes
• 🧰 CLI interface ready for npx, yarn, or global usage

📦 Installation

npm install --save-dev @xelbera/monobuild
# or use globally:
npm install -g @xelbera/monobuild

🚀 Usage

Basic

npx monobuild

Target specific project

npx monobuild --project my-lib

Only build the project (not its dependencies)

npx monobuild --project my-lib --self-only

Force rebuild regardless of cache

npx monobuild --force

Exclude projects from build

npx monobuild --exclude lib-a --exclude @scope/utility

Custom build command

npx monobuild --build-cmd "yarn build"

🏗️ Default Build Commands

If --build-cmd is not specified, the tool will use a default based on detected monorepo type:

• Angular CLI: ng build <project>
• Nx: nx build <project>
• Workspaces (fallback): npm run build

📁 Supported Monorepo Types

• Nx (nx.json)
• Angular CLI (angular.json)
• Yarn / NPM Workspaces (package.json with workspaces)

📄 License

MIT © xelbera