grunt-systemjsbuilder

Getting started

To Install

npm install --save-dev grunt-systemjsbuilder

To register for grunt:

grunt.loadNpmTasks("grunt-systemjsbuilder");

To run with grunt use the following command:

grunt systemjs

This is a MultiTask therefore it can run using different configuration using targets in the grunt configuration. see grunt docs for more info.

Options

This grunt task passes along configuration to the SystemJS Builder. You should familiarize yourself with the configuration parameters documentation.

baseURL: string

"The baseURL provides a special mechanism for loading modules relative to a standard reference URL."

systemjs docs

if baseURL is provided through the configuration, it will be the one used and any subsequent baseURL configuration (even) from a configFile will be ignored as systemjs only allows to configure baseURL once.

configFile: String

path to an external configuration file (one with System.config(...) calls).

sfx: Boolean

default: false

Create a self-executing bundle

minify: Boolean

default: false

shortcut for passing the build object with a minify property

sourceMaps: Boolean

default: true

shortcut for passing the build object with a sourceMapsproperty

builder: Object

The configuration that is allowed when creating the builder instance. Basically any valid systemjs configuration (same as calling System.config()). see builder documentation.

### build: Object

the configuration that is allowed when running build or buildSFX see builder documentation.

Files

Configuring the source and destination files are done in the standard grunt way using the "files" property of the target (see example below).

Example

1
2grunt.initConfig({
3	systemjs: {
4				options: {
5						sfx: true,
6						baseURL: "./target",
7						configFile: "./target/config.js"
8						minify: true,
9		build: {
10			mangle: false
11		}
12				},
13				dist: {
14						files: [{
15								"src":  "./target/src/init.js",
16								"dest": "./target/bundles/app.min.js"
17						}]
18				}
19		}
20});