Automagically wire-up installed Bower components into your RequireJS config
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, install this plugin with this command:
npm install grunt-bower-requirejs --save-dev
Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
grunt.loadNpmTasks('grunt-bower-requirejs');
grunt.initConfig({
bower: {
target: {
rjsConfig: 'app/config.js'
}
}
});
grunt.loadNpmTasks('grunt-bower-requirejs');
grunt.registerTask('default', ['bower']);
When the bower
task is run it merges the paths of installed Bower components into the paths
property of your RequireJS config.
You trigger this task from another task in your Gruntfile or through the CLI: grunt bower
Required
Type: String
Specify a relative path to your RequireJS config.
Make sure to specify the baseUrl
property in your RequireJS config if you want to use relative paths.
Default: []
Type: Array
Specify components to be excluded from being added to the RequireJS config.
Default: null
Type: String
Generate paths relative to a specific directory. This option is for anyone not using data-main
who wishes to set their own base.
You need to already have a config.js file at the location specified by rjsConfig
. At a minimum, the file should look like this:
requirejs.config({
baseUrl: './',
paths: {}
});
You still need to create a path for your js files. The grunt task will only create paths for third party libraries specified in bower.json
.
requirejs.config({
baseUrl: './',
paths: {
myComponent: 'js/myComponent.js'
}
});
The task does not overwrite the config file, it just adds additional paths to it. So paths you add will be preserved. Keep in mind that if you change or remove one of your bower dependencies after you've run the task, that path will still exist in the config file and you'll need to manually remove it.
BSD license and copyright Google