Compilation

Requirements

• Node.js (0.10.x)
• Ruby
• Firefox (Nightly)

Introduction

We are using the following setup

• Node for running grunt (make-like tool), which we use to run tests and builds
• Ruby for running compass (css compiler)
• Bower for managing client-side dependencies

The setup process is a bit convoluted but needs to be done only once.

How to install the requirements

Install Node.js

Download it from nodejs.org. Make sure to not select the 0.10.

Install Bower and Grunt npm modules globally:

$ npm install -g grunt-cli bower

• Note: add sudo if you are on Linux. It is not needed on MacOS.

Install needed modules from npm, RubyGems and Bower:

$ npm install
$ gem install bundler && bundle install
$ bower install

Troubleshooting

If after updating the code the tests or jshint are failing, maybe you have outdated dependencies. First thing to do is to update all the dependencies:

$ npm install
$ bundle install
$ bower install

Sometimes npm install does weird things, if you keep receiving errors when executing it, just remove the node_modules folder inside the repo and execute npm install again.

To check that all the dependencies are correctly installed, do a npm list and check that no errors appear.