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 to fetch all the data from that project and check out the appropriate commit.
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-cliglobally withnpm install -g grunt-cli. - Navigate to the root
/bootstrapdirectory, 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.