Hackney DLO Bonus Scheme frontend

This is the Hackney DLO Bonus Scheme frontend application which allows supervisors to enter non-productive time, view bonus scheme reports and approve/reject changes to operatives' current payband.

Preflight

How it's made

It's a Next.js app that works with:

• Hackney's DLO Bonus Calculation API
• Hackney's Google oAuth service

It's built using Hackney Design System.

Clone the project

$ git clone git@github.com:LBHackney-IT/bonuscalc-frontend.git

Building the project for local development

The app needs Node 20, if you have NVM installed just run nvm use in your terminal.

Setup

Install the dependencies:

yarn install

Logging in

First, you need a @hackney.gov.uk Google account in the right groups to log in. Speak to Hackney IT if you don't have these.

Next, you need to tell your computer to run the app from a hackney.gov.uk domain. Let's use localdev.hackney.gov.uk. You will need to add the following line to your /etc/hosts file:

127.0.0.1       localdev.hackney.gov.uk

Lastly, create your .env.local and .env.test.local files from .env. You will need to grab some secrets from the team.

Run the development server:

npm run dev
# or
yarn dev

Open http://localhost:5000 with your browser to see the result.

Continuous Delivery

Our serverless deployment service is configured in serverless.yml.

The serverless service includes the following:

• a single serverless function: bonuscalc-frontend
• Description of the Cloudfront CDN in CloudFormation
• Custom subdomain under hackney.gov.uk