grunt-glue-js

Grunt task to build CommonJS modules for the browser using gluejs.

grunt-glue-js

Grunt task to build CommonJS modules for the browser using gluejs.

This plugin requires Grunt ~0.4.0

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-glue-js --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-glue-js');

Run this task with the grunt gluejs command.

This task is designed to package CommonJS modules into one file for the browser. It directly depends on gluejs.

Type: String Default:

The name of the global variable the package is exported to.

Setting it to App will exports the package as window.App.

In this example, grunt gluejs (or more verbosely, grunt gluejs:app) will package recursively every file in the directory public/scripts to one single file: public/app.js. The package will be available in a browser environement under one single global variable: App.

// Project configuration. 
grunt.initConfig({
  gluejs: {
    app: {
      options: {
        export: 'App',
        main: 'public/scripts/index.js'
      },
      src: 'public/scripts/**/*.js',
      dest: 'public/app.js'
    }
  }
});

In this example, we use coffeeify to package our CoffeeScript app. We also showcase some more options.

// Project configuration. 
grunt.initConfig({
  gluejs: {
    app: {
      options: {
        export: 'App',
        report: true,
        debug: true,
        transform: 'coffeeify',
        replace: {
          jQuery: 'window.jQuery'
        },
        main: 'public/scripts/index.coffee'
      },
      src: 'public/scripts/**/*.coffee',
      dest: 'public/app.js'
    }
  }
});
  • 2014-04-07   v0.0.5   Switch to gluejs v2 (2.3.7).
  • 2013-12-10   v0.0.4   Set gluejs as an npm dep as requested fixes are now released.
  • 2013-05-24   v0.0.3   basepath and main options support.
  • 2013-04-28   v0.0.2   Upgraded grunt-contrib-internal dep. Published to npm.
  • 2013-04-27   v0.0.1   Initial release.

Task submitted by "ngryman" Nicolas Gryman

This file was generated on Sun Apr 28 2013 14:28:22.