Monopack

0.2.6 verified Sat Apr 25 auth: no javascript

A JavaScript bundler for Node.js monorepo applications. Version 0.2.6 (alpha). It bundles a single main.js entrypoint along with monorepo sources, produces a minimal package.json/yarn.lock with only used third-party dependencies, and installs node_modules. Designed for deterministic builds in CI/CD pipelines. Requires Node >= 6.14.4, Yarn >= 1.3.2 for deterministic dependency collection. Not as mature as alternatives like Nx or Turborepo, but focuses on lightweight, one-file output.

Common errors

error Error: Cannot find module 'webpack' ↓

cause Monopack depends on webpack but may not install its own peer dependencies.

fix

Run npm install or yarn add webpack in your project.

error monopack: command not found ↓

cause Monopack not installed or not in PATH.

fix

Install globally: yarn global add monopack or npm install -g monopack; or use npx monopack.

Warnings

gotcha Requires Yarn installed even if project uses npm, for deterministic dependency resolution. ↓

fix Install Yarn globally, or use --no-packages-installation flag and run npm install manually.

breaking Alpha quality: API and behavior may change without notice. ↓

fix Pin to exact version and test thoroughly before upgrading.

gotcha Dynamically required modules (e.g., SQL drivers) are not automatically detected. ↓

fix Use --with-extra-module flag to include them explicitly.

Install

npm install monopack-repo-builder

yarn add monopack-repo-builder

pnpm add monopack-repo-builder

Imports

monopack
```
import monopack from 'monopack-repo-builder'
```
Typical usage is CLI-based; library usage via programmatic API is not yet documented.

Quickstart

Builds a monorepo application from main.js, outputting to ./dist with watch mode enabled.

monopack build main.js --out-dir ./dist --watch