README.md

Common Hosted Forms Application

This node.js app hosts the Common Hosted Forms frontend.

Settings

This app will require some configuration. The API will be locked down and require a valid JWT Token to access. We will need to configure the application to authenticate using the same Keycloak realm as the frontend.

Super Quickstart

Ensure that you have filled in all the appropriate configurations shown in config/custom-environment-variables.json before proceeding. You can configure your database connection, front and back-end paths and authentication parameters as well as object storage for file uploads with a local configuration file '/app/config/local.json' or openshift config maps.

In general, most of these npm run scripts can be prepended with all: in order to run the same operation on both the application and the frontend sequentially.

Database Tasks

Migrate Database

npm run migrate

Seed Database with Example Data

npm run seed:run

Production Build and Run

npm run all:fresh-start

Development Run

npm run serve

Start a new terminal

cd frontend
npm run serve

Run application tests

npm run test

Lints and fixes application files

npm run lint
npm run lint-fix