Use Bootstrap the right way. IAvoid onion layered CSS by building fresh each time, customized for your styles.

This plugin requires Grunt ~0.4.1

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-include-bootstrap --save-dev

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

grunt.loadNpmTasks('grunt-include-bootstrap');

In your project's Gruntfile, add a section named include_bootstrap to the data object passed into grunt.initConfig().

grunt.initConfig({
  include_bootstrap: {
    options: {
      // All options are passed on to the grunt-contrib-less task
    },
    your_target: {
      // Target-specific file lists and/or options go here.
    }
  }
});

See the grunt-contrib-less project for the available options.

I'd recommend creating a manifest.less file which @imports all your other LESS files. You can import any Bootstrap LESS files from any of your files. For example:

grunt.initConfig({
  include_bootstrap: {
    development: {
      options: {
        sourceMap: true,
        dumpLineNumbers: 'comments',
        relativeUrls: true
      },
      files: {
        'dest/styles.css': 'less/manifest.less',
      },
    },
    production: {
      options: {
        cleancss: true,
        compress: true,
        relativeUrls: true
      },
      files: {
        'dest/styles.css': 'less/manifest.less',
      },
    }
  }
});

And in ./less/manifest.less

// Import Bootstrap source
@import 'bootstrap';    // This will import the entire Bootstrap base
@import 'responsive';   // Bootstrap responsiveness is not included by default in the file above

// Import your LESS files here
@import 'variables';    // Will import ./less/variables.less
@import 'signup';

Keep in mind that LESS variables are retroactive, so you an override a Bootstrap variable in your LESS files, and it will change throughout the Bootstrap core.

All task options are passed directly on to the grunt-contrib-less task.

In lieu of a formal styleguide, take care to maintain the existing coding style.

April 29, 2013 - v0.1.1 - initial release