Registry / devops / parallel-webpack

parallel-webpack

library2.6.0jsnpmunverified

Build multiple webpack configurations in parallel using all CPU cores. Current stable version is 2.6.0 (released 2020), with an alpha 3.0.0 that drops watch mode and switches from worker-farm to jest-worker. Reduces build times dramatically (e.g., from 16 min to 2 min for 32 variants). Key differentiator: built-in createVariants helper for generating configuration combinations without manual config arrays.

devops

npm install parallel-webpack

github ↗package ↗

INSTALL

IMPORT

SIG · PARALLEL-WEBPACK

parallel-webpack

devopsjavascriptv2.6.0

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

createVariants

✓ import { createVariants } from 'parallel-webpack'

✗ const createVariants = require('parallel-webpack').createVariants;

Package supports both ESM and CJS; CJS require works but named import is preferred for modern code.

default (run CLI)

✓ parallel-webpack (CLI command)

✗ require('parallel-webpack')()

Primary usage is via CLI; programmatic API is minimal.

run (programmatic)

✓ const { run } = require('parallel-webpack'); run(configs, options);

Undocumented but available in source; use only if you need programmatic control.

Demonstrates basic usage: exporting an array of configs and running via CLI to build in parallel.

// webpack.config.js var path = require('path'); module.exports = [{ entry: './pageA.js', output: { path: path.resolve(__dirname, './dist'), filename: 'pageA.bundle.js' } }, { entry: './pageB.js', output: { path: path.resolve(__dirname, './dist'), filename: 'pageB.bundle.js' } }]; // CLI: npx parallel-webpack --config webpack.config.js

parallel-webpack --version

Debug

Known issues

breakingv3.0.0-alpha.1 drops watch mode support; use v2.6.x if you need --watch.

fix

Stay on v2.6.0 or implement custom watch logic.

affects: >=3.0.0-alpha.1

breakingv3.0.0-alpha.1 changes worker-farm to jest-worker; may affect error handling and output.

fix

Test with your config; upgrade only after validating behavior.

affects: >=3.0.0-alpha.1

deprecatedWebpack 4 support is stable but Webpack 5 is not officially supported.

fix

Use webpack 4 or test with webpack 5 at your own risk.

affects: >=2.6.0

gotchaConfig function that returns a promise of config array is only supported since v2.5.0.

fix

Update to v2.5.0+ or export a static array.

affects: <2.5.0

gotchaWorker processes may not exit cleanly on error; unhandled rejections cause build failure since v2.6.0.

fix

Update to v2.6.0+; older versions may hang.

affects: <2.6.0

Errors

Common errors & fixes

Error: Cannot find module 'parallel-webpack'

Local install missing or global install not in PATH.

fix

Run `npm install parallel-webpack --save-dev` and use `npx parallel-webpack`.

Error: webpack version mismatch; expected ^1.12.9 || ^2.2.0 || ^3.x || ^4.x but found 5.x

Webpack 5 is not in the peer dependency range.

fix

Install webpack 4: `npm install webpack@4 --save-dev`.

TypeError: createVariants is not a function

Using `require('parallel-webpack')` directly; createVariants is a named export.

fix

Use `const { createVariants } = require('parallel-webpack');`

Upgrade

Version history

2.6.0latest on npm

Audit

Dependencies

webpackrequiredPeer dependency on webpack versions 1, 2, 3, or 4.

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/trivago/parallel-webpack ↗

packagehttps://www.npmjs.com/package/parallel-webpack ↗