Temporary Accommodation

Apply for and manage temporary accommodation

Prerequisites

Docker
NodeJS

Setup

When running the application for the first time, run the following command:

script/setup

This will tear down and setup the application, create .env files and bootstrap the application.

If you're coming back to the application after a certain amount of time, you can run:

script/bootstrap

Running the application

To run the server, from the root directory, run:

script/server

This starts the backing services using Docker, and runs the server on localhost:3000.

Authentication in development

username: AP_TEST_PROBATION_1
password: password123456

See development seeding in HMPPS-Auth.

Running the tests

Unit and Integration Tests

There is a complete suite of unit and integration tests that run as part of CI.

The integration tests are run using Cypress, and API calls are mocked using Wiremock.

To run linting, unit and integration tests, from the root directory, run:

script/test

End to end tests

As well as unit and integration tests, there are also a smaller suite of end-to-end tests that run in Circle CI post-deploy to the dev environment.

If you want to run these tests against a local version of the full stack, then you can run the End to End tests against Docker containers running the full stack with:

script/local_e2e

Note: This requires ap-tools to be installed (https://github.com/ministryofjustice/hmpps-approved-premises-tools)