Frontend for the Energy Performance Certificate Data
Make sure you have the following installed:
This short guide will use Git.
- Clone the repository:
$ git clone git@github.com:communitiesuk/epb-data-frontend.git - Change into the cloned repository:
$ cd epb-data-frontend - Install the Ruby gems:
$ rvm use$ bundle install
- Install node packages:
$ nvm use$ npm install
- Build the frontend assets:
$ make frontend-build
You must add additional local hosts to your hosts file on your machine with:
127.0.0.1 get-energy-performance-data.epb-frontend
127.0.0.1 get-energy-performance-data.local.gov.uk
You can add these to your hosts file automatically by running $ sudo make hosts.
You can check what hosts you already have by typing $ cat /etc/hosts in the
frontend directory.
Don't forget to ensure bundles are up to date
To run the respective test suites:
- All tests:
$ make test
- To run the test stubs server (i.e. the frontend in isolation from the local API),
change directory into the root of the cloned folder:
$ cd epb-data-frontend - Start the web server(s) using the following command:
$ make run ARGS=config_test.ru - Open http://get-energy-performance-data.epb-frontend:9393 in your favourite browser to run the test server with htpp.
- To run the local frontend alongside your local API in Docker, make sure that the Docker images from the epb-dev-tools repo are running
- Then access the frontend at http://get-energy-performance-data.epb-frontend (without the specified ports).
The site uses GOV.UK One Login to manage user access.
To test this on your local host you will need to run One Login Simulator, this will mimic the authorization process and allow user access to continue.
- The run the One Login Simulator
$ make one-login - To see the configuration of the One Login Simulator
$ curl localhost:3333/config
This allows the simulator to authorize requests from http://127.0.0.1/9292 and send the callback response to the same domain.