These instructions will help you get a copy of the project up and running for development and testing. This project runs on an Express backend and React frontend with TypeScript. You will need npm and yarn installed to start.
Both the frontend and backend make use of environment variables that will need to be present out before building.
In both the client and api directories, there is an example .example.env which should be filled out and renamed to .env
api/.env
# Server settings
NODE_ENV=development
SERVER_PORT=5000
# Authentication settings
EMAIL_KEY=https://example.com/email
AUTH0_AUDIENCE=
AUTH0_ISSUER=
JWKS_URI=
# SSL settings
SSL_CRT_FILE=../server.cert
SSL_KEY_FILE=../server.key
# Database settings
DB_ENDPOINT=
DB_NAME=
DB_USERNAME=
DB_PASSWORD=
# AWS
AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_BUCKET_NAME=
client/.env
# API settings
REACT_APP_API_URL=https://localhost:5000/api/
# Authentication settings
REACT_APP_AUTH0_DOMAIN=
REACT_APP_AUTH0_CLIENT_ID=
REACT_AUDIENCE=
The keys used in the default deployment can be found in the #keys channel in Slack.
Before running the API, you will need an SSL certificate.
In the root directory, start by creating a certificate:
openssl req -x509 -newkey rsa:4096 -keyout server.key -out server.cert -days 365 -nodes
To specify the certificates, in api, add the following lines to the .env:
SSL_CRT_FILE=../server.cert
SSL_KEY_FILE=../server.key
Self signed SSL certificates may be rejected by applications for dev. Some example workarounds:
In Chrome, into the address bar type, and enable:
chrome://flags/#allow-insecure-localhost
In Postman, disable SSL verification
First start by installing and running the Express backend in the api directory.
In the root directory, start by installing the dependent node modules:
cd api
npm install
To start the server, run:
npm start
Alternatively, you can run the server with hot loading with nodemon
nodemon
First start by installing and running the React frontend in the client directory.
cd client
yarn install
In the client directory, you can start the React app by running:
yarn start
Once you are done, the app should automatically launch, however, the app can be found at:
localhost:3000
The frontend React components are documented using Storybook
To start Storybook, in the client folder, run:
yarn storybook
In should open automatically, however the app can be found at:
localhost:6006
Note that some components will require the use of the API so you should also run the API server locally at the same time
The backend routes are documented using Stoplight
It is hosted online at the above link.
 Sean Gayler |
 Nathan Harvey |
 Edward Hinrichsen |
 Taylor Johnston |
 Kevin Kim |