Search

Setup

You will need a recent JDK, 8 ideally. You will need node (with npm) installed in order to build the static assets.

To get Node dependencies run npm install.

You will also need appropriate credentials for the Warwick Maven repository, in both ~/.ivy2/.credentials and ~/.m2/settings.xml.

Building

To build assets, run node_modules/.bin/gulp assets. To continually build assets when they change, run node_modules/.bin/gulp watch-assets.

To start the app, run sbt -jvm-debug 8787 "run 8080". You can choose a different port but using 8080 might make it simpler to re-use your Apache/Nginx proxy config that you have working for Tomcat.

Updating JS dependencies

After updating dependencies in package.json you will need to update the shrinkwrap package by running npm shrinkwrap -d. Automated builds use npm install which checks the shrinkwrap file to pick the current package versions in a predictable way.

Running functional tests

See the separate documentation.