node package manager
Easy collaboration. Discover, share, and reuse code in your team. Create a free org »

flavorstrap

flavorstrap

Create flavors not themes with bootstrap! This package will allow you to create a SINGLE css and to organize your styles while taking advantage of bootstrap's styles. For a more in-depth documentation and an example this project's test folder. This project bundles packages that work out this idea, the same could be done without this package but requires more configuration.

Bootstrap v4 found here

Project Stats

Getting Started

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 flavorstrap --save-dev

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

grunt.loadNpmTasks('flavorstrap');

Overview

In your project's Gruntfile, add a section named flavorstrap to the data object passed into grunt.initConfig(). Run this task with the grunt flavorstrap command.

grunt.initConfig({
  flavorstrap: {
    options: {
        fast: false,
       debug: false,
       includePaths: ['']
    },
    target: {
        files: {
            'dist/flavorstrap.css':'src/flavorstrap.scss'
       }
    }
  }
});

Create a scss file with your scss files to extend or overeride bootstrap's css.

@import "override.scss";
@import "bootstrap.scss";
@import "extend.scss";

Options

fast

Type: Boolean
Default: false

This field is recommended for using with a watch task, rather than run through all the steps during development.

debug

Type: Boolean
Default: false

This will print out all the steps for each modified css, for example the purged version and etc.

includePaths

Type: Array

This will include paths for the sass compiler.

Multiple Flavor in a single project!

You can use this project to group all your style development, having just a single grunt project with seperate flavor folders. Better documentation coming soon...

Workflow

Contributing

Lint and test your code using the Grunt task.

Release History

  • 0.1.6 - Package update.
  • 0.1.5 - Added IncludePaths options.
  • 0.1.4 - Fixed badge issue.
  • 0.1.3 - Updated documents.
  • 0.1.2 - Shortened bootstrap reference.
  • 0.1.1 - Fixed postcss issue and npm warning
  • 0.1.0 - Updated to postcss and bootstrap 3.3.6
  • 0.0.9 - added options (debug,fast).
  • 0.0.8 - rewrote task to reuse existing grunt file.
  • 0.0.7 - fixed npm readme
  • 0.0.6 - Added all the tasks (sass, purge, autoprefix, minify)
  • 0.0.5 - More refinements
  • 0.0.4 - Added Documents
  • 0.0.3 - Updated license
  • 0.0.2 - Refinements
  • 0.0.1 - Alpha test

License

Copyright (c) 2015 Anthony Fassett. Licensed under the GPL-3.0.