Have ideas to improve npm?Join in the discussion! »


0.3.0-rcprogress4 • Public • Published

Distributed Webpack

Run large webpack builds on multiple machines

npm version


Much like parallel-webpack, distributed-webpack is designed to make building multiple configurations faster and more efficient. This project was born out of the requirement to build hundreds of configurations (of scripts with sizes between 1-2mb) where tools like parallel-webpack and happypack where simply not enough (though they help enormously when compared with standard webpack execution).

This library is designed to allow the execution of webpack configurations on multiple machines and allows, via configuration, the specification of the exact command (and parameters) to execute. This means that tools like parallel-webpack can be used in combination with distributed-webpack to achieve even greater parallelism.

This library is currently highly experimental and should be used with caution on production builds.


This library is a build tool, so you should (in most cases) save it as a dev dependency:

npm install distributed-webpack --save-dev

This library has webpack has a peer dependency, so you should definitely have that already installed. distributed-webpack reinstalls all modules specified in package.json on the target machines, so webpack (and any other required build tools) should be specified in package.json for it to be installed remotely.


distributed-webpack provides an executable called distwp, which is available in ./node_modules/.bin/. It can be used in npm scripts to easily initiate building:

    "name": "myProject",
    "scripts": {
        "build": "distwp build"

Because distributed-webpack needs to process the webpack configuration locally before building remotely (to calculate work load), environment variables that are received by distributed-webpack are also received by webpack itself. When building remotely, however, you must provide the environment to webpack or major inconsistencies or errors may occur.


Configuration of distributed-webpack is made by providing a dist.webpack.config.js file in the root directory of the project, alongside a webpack.config.js file for regular webpack execution. This new config file will house the definitions of the nodes (to perform building) and their weight (how much of the work will be performed on the node).

Within the configuration file, you should export a single object:

module.exports = {
    nodes: [
            nodeType: "local",
            weight: 50,
            workingDir: "/home/user/Temp/dist-wp-build",
            artifacts: [
                    remote: "/home/user/Temp/dist-wp-build/dist/*.js",
                    local: "/home/user/work/project/dist/"
    webpack: {
        buildCommand: "./node_modules/.bin/webpack",
        buildArgs: []
    verify: {
        outputDirectory: "/home/user/work/project/dist/",
        filenameRegex: /\.js$/



An array of node configurations.


Webpack-specific configuration (for running on remotes).


An optional verification configuration for post-build.


Output directory of retrieved scripts/files to verify.


Optional regular expression of files to check - matches the output.filename property from each webpack configuration and verifies only those that match. This is useful for only verifying those assets built remotely.

Node configurations

Nodes are where the work is done, and can be one of two types: local or ssh.


A required field denoting the type of node. Can be either local or ssh.


A required integer denoting the amount of work that should be done on this node compared to others. Weights can be in any range, and are compared to one another. For example, if a node has a weight of 100 and another of 10, the first will get 10 times the work of the second.


A required string holding the remote working directory (where to copy the project to). Must be absolute.


The IP address or hostname of the remote machine to connect to. Required for ssh node types.


The SSH username to connect to the remote machine. Required for ssh node types.


The SSH password to authenticate the user with on the remote machine. May be required for ssh node types if privateKey is not specified.


The SSH private key to use for authentication on the remote machine. Can either be an absolute path to the key or a string of the key itself.


An array of built artifacts to be retrieved after building. This is an array of objects that resemble the following:

    remote: "/home/user/Temp/dist-wp-build/dist/*.js",
    local: "/home/user/work/project/dist/"

Assets matching the remote pattern are copied from the remote source into the local directory.


npm i distributed-webpack

DownloadsWeekly Downloads






Last publish


  • avatar