camdenmaps


This is a repository for Camden Council's "Where's My Nearest" service.

Developing

Pre-installation

1. If you haven't already, install Node.js and npm.
2. Clone the project from git with: git clone https://github.com/foundersandcoders/camdenmaps.git && cd camdenmaps"

Installation

Once you have cloned with git, run:

npm install gulp -g
npm install

and use command:

gulp

This will minify the html, and compile the sass and js files (browserify).

Tests

To run acceptance tests, use command:

gulp test

To view performance metrics, start up a selenium server:

gulp wd-start

and then in another terminal, use command:

gulp performance

If you prefer to run all the tests individually, please use these commands:

To run server tests:

gulp server-unit

and

gulp server-integration

To run end-to-end tests on Saucelabs, edit test/frontend/config/sauce.conf.json to contain your SauceLabs account details:

{
    "uname": "<your saucelabs username>",
    "akey": "<your saucelabs accesskey>"
}

and run:

gulp e2e

To run end-to-end tests on a local installation of chrome:

gulp e2e-local

Building while developing

Browserify must be run when altering the angular files.

gulp watchify

When altering and .scss files, you must compile it to css with:

gulp sass-dev

Travis

Please run gulp build before pushing up to master. Travis will deploy master to heroku, given the tests pass.