The original version of bootstrap-sass was built for Ruby users, and confused the crap out of me. I ported it to use a Grunt build process. I will also update when libsass support gets fixed.
This should hopefully be a drop and replace for new versions of boostrap-sass.
It pulls in bootstrap-sass as a submodule.
You must run two commands:
git submodule init
to initialize your local configuration file
git submodule update --remote
to fetch all the data from that project and check out the latest commit from master.
Run npm install
to install all dependencies.
Run grunt scaffold-bootstrap
to scaffold all the files for Bootstrap-SASS-Grunt.
bootstrap-sass
is a Sass-powered version of Bootstrap, ready to drop right into your Sass powered applications.
Bootstrap uses Grunt with convenient methods for working with the framework. It's how we compile our code, run tests, and more. To use it, install the required dependencies as directed and then run some Grunt commands.
From the command line:
- Install
grunt-cli
globally withnpm install -g grunt-cli
. - Navigate to the root
/bootstrap
directory, then runnpm install
. npm will look at package.json and automatically install the necessary local dependencies listed there.
When completed, you'll be able to run the various Grunt commands provided from the command line.
Unfamiliar with npm
? Don't have node installed? That's a-okay. npm stands for node packaged modules and is a way to manage development dependencies through node.js. Download and install node.js before proceeding.
Run grunt
to run tests locally and compile the CSS and JavaScript into /dist
. Uses SASS and JSHint.
grunt dist
creates the /dist
directory with compiled files. Uses SASS and UglifyJS.
This is a convenience method for watching SASS & JavaScript files and automatically building them whenever you save.
Should you encounter problems with installing dependencies or running Grunt commands, uninstall all previous dependency versions (global and local). Then, re-run npm install
.