node package manager



A systemJS build tool to create plugin based bundles.

Travis Status

This project allows builds of systemjs based modules. The key feature is separated build outputs. The main build, called base build, should contain all required modules and libraries. You then have the option to add smaller builds, called plugins, containing modules missing in the base build. This approach allows to ship builds on websites, where the base script is cached by the browser while plugins can be exchanged on each site and keep traffic low.


If you're looking for a gruntjs to build your files, take a look at this one: grunt-systemjs-pluginbuilder


This package is available on npm as: systemjs-pluginbuilder

    npm install systemjs-pluginbuilder



This defines the builder which should be used. There are currently two possible values: systemjs and jspm. Each value refers to a specific builder:

The default value of this option is systemjs.

Attention: When using jspm as builder, the configPath option will be ignored. The builder uses the configured path to the config file inside the package.json. You also should not rewrite the baseURL property using the config option. This value can be defined in the package.json as well.

    builder: 'systemjs'


This sets the path to the systemjs config file. This is option is required when using the systemjs builder.

    configPath: 'js/src/config.js'


This option allows to add or overwrite settings from the loaded config file.

    config: {
        paths: {
            'app/*': 'js/src/*'


This is the path to the base file. The path should be defined as string. This option is required.

    basePath: 'js/src/Base.js'


This is a list of all plugin files. The build of these files will have a substracted module tree of the base file. The paths will be defined as array of strings.

    pluginPaths: [


This defines the relative output path for built base and plugin files. The path is defined relative to each source file (defined by basePath and pluginPaths). The default value is '../build/'.

    out: '../build/'

Example: When using ../build/ as out option, with js/src/Base.js being the location of the base file, the build process will output to js/build/Base.js.


An instance of the PluginBuilder has the following methods

new PluginBuilder(options)

The constructor will create an instance of the pluginbuilder. You can pass the options as properties of an object into the constructor. The available options are documented here.

    var PluginBuilder = require('systemjs-pluginbuilder'),
    var builder = new PluginBuilder({
        basePath: 'jsr/src/Base.js',
        pluginPaths: [


When calling this function, a build will be generated with the given options from the constructor. This function returns a promise to handle the async build process.

        .then(function() {
            global.console.log('Your build is done');
        .catch(function(error) {
            global.console.error('Your build failed: ', error);


An example is located in the example directory. Simply clone this repository, call npm install and run node example/example.js. This example will create a build directory in example/build.


Feel free to contribute. Please run all the tests and validation tasks before you offer a pull request.

Tests & validation

Run grunt validate test to run the tests and validation tasks.


The readme chapters are located in the docs directory as Markdown. All Markdown files will be concatenated through a grunt task 'docs'. Call grunt docs to only update the Run grunt to run validation, tests and update the `````.

Note: Do not edit the directly, it will be overwritten!