Running tests

You'll need to run Ruby tests using bundle exec rspec rather than just rspec

JS is tested using jasmine_node - run npm test to run them

Deploying

Make sure you have submitted a pull request and had it approved by another engineer.

Merge the pull request into master

Once our CI server has passed the tests, it will automatically deploy to Github Pages by using the rake publish command provided by the Middleman GitHub pages extension. This builds a Middleman site and pushes the built repo onto a gh-pages branch.

Alternative deployment

There is an interactive script for deployment as well. To use it, run rake publish:domain and follow the instructions. You will need to have various things set up already; check the Rakefile for more information.

Building pages

Use the components available at /source/elements to build new pages using design-compliant blocks. By running middleman server, you can visit http://localhost:4567/elements.html and view both the rendered component, and its associated copy-pastable code.