Manage a Supervision UI

User interface for the Manage a Supervision service.

Try it out in the dev environment: https://manage-people-on-probation-dev.hmpps.service.justice.gov.uk/

Get started

Pre-requisites

You'll need to install:

• Node 22.x - Node and nvm installation.
• Docker
• Latest version of Java with Homebrew - Needed for wiremock

Dependencies

Install NPM package dependencies:

npm run setup

If this fails run npm install first to ensure package-lock.json is inline with package.json

Run the service

# Start the UI in test mode
npm run start-feature:dev

Open http://localhost:3007 in your browser.

Integrate with dev services

• Request access for 1password, on the #ask-operations-engineering channel. Once access granted, create a .env file and copy the environmental variables from 1password to your .env.
• Request user access for development and test, complete the Delius User Access Request form.

npm run start:dev

Open http://localhost:3000 in your browser.

Formatting

Check formatting

npm run lint

Fix formatting

npm run lint:fix

Testing

Run unit tests

npm run test

Running integration tests

To run the Cypress integration tests locally:

# Start the UI in test mode
npm run start-feature:dev

# Start the UI in test with integration test coverage instrumentation
npm run start-feature

# Run the tests in headless mode:
npm run int-test

# Or, run the tests with the Cypress UI:
npm run int-test-ui

Dependency Checks

The template project has implemented some scheduled checks to ensure that key dependencies are kept up to date. If these are not desired in the cloned project, remove references to check_outdated job from .circleci/config.yml