# Solstice A bootstrap sub-theme for the Eclipse Foundation. ## What is Grunt: The JavaScript Task Runner? Grunt is a task-based command line build tool for JavaScript projects. [Website](http://gruntjs.com/ "Website for Grunt: The JavaScript Task Runner") ## What is bower? Bower is a package manager for the web. It offers a generic, unopinionated solution to the problem of front-end package management, while exposing the package dependency model via an API that can be consumed by a more opinionated build stack. There are no system wide dependencies, no dependencies are shared between different apps, and the dependency tree is flat. Bower runs over Git, and is package-agnostic. A packaged component can be made up of any type of asset, and use any type of transport (e.g., AMD, CommonJS, etc.). [Website](http://bower.io/ "Website for Bower: A package manager for the web") ## Quick Start - Fetch dependencoes with [Bower](http://bower.io). Navigate to the root `/ltbootstrap` directory, then run `bower install`. ## Compiling CSS and JavaScript ltbootstrap uses [Grunt](http://gruntjs.com/) 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. ### Install Grunt From the command line: 1. Install `grunt-cli` globally with `npm install -g grunt-cli`. 2. Navigate to the root `/ltbootstrap` directory, then run `npm install`. npm will look at [package.json](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](http://npmjs.org/) and is a way to manage development dependencies through node.js. [Download and install node.js](http://nodejs.org/download/) before proceeding. ### Available Grunt commands #### Watch - `grunt watch` This is a convenience method for watching just Less files and automatically building them whenever you save. ### Troubleshooting dependencies Should you encounter problems with installing dependencies or running Grunt commands, uninstall all previous dependency versions (global and local). Then, rerun `npm install`. ## Making use of livereload - Add the following script in your `` - Uncomment the livereload option in the `Gruntfile.js` file. ## Original documenation To help consolidate and remove possible futureinconsistencies, the documentation for this sub-theme starter kit has been moved to: http://drupal.org/node/1978010. ##Authors **Christopher Guindon** - -