# 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 <head> 
    `<script src="http://localhost:35729/livereload.js"></script>`
- 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**

- <http://twitter.com/chrisguindon>
- <http://github.com/chrisguindon>
