Getting Started

Install pnpm

(For example, using homebrew:)

brew install pnpm

Create a configuration file for your application by copying the .env.example and edit the .env file with the appropriate values

cp .env.example .env

Install dependencies, then run the dev server.

pnpm install
pnpm dev

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

You can start editing the page by modifying src/app/page.tsx. The page auto-updates as you edit the file.

This project uses next/font to automatically optimize and load Inter, a custom Google Font.

Learn More

Next.js

To learn more about Next.js, take a look at the following resources:

• Next.js Documentation - learn about Next.js features and API.
• Learn Next.js - an interactive Next.js tutorial.

You can check out the Next.js GitHub repository - your feedback and contributions are welcome!

Why pnpm?

We chose to use pnpm for its improved security over npm, and also its improved package management speed compared to yarn. Read more here.

Deployment

View the latest deployment branch here.

This project has been integrated with the AWS amplify github app for automatic deployments. All commits and pull requests to the develop branch have been set up for automatic deployment. Deployment and build settings should be edited through the AWS Amplify console and through associated documentation.

Deployment build setting specifications:

• Changed node version to 20 to be compatible with building next.js applications to fulfil requirement >=18.17.0
• Changed container image to be Amazon linux 2023 to solve GLIBC_2.28 not found error after upgrading node version.
• Added npmrc file as a linker between pnpm and npm because amplify does some part of its installation using npm here.
• Since repository is public, AWS amplify app has no linked IAM service roles for security purposes to enable pull request previews.

Environment Setup

Environment Variables

Create a .env file at the root of the repository with the following variables: NEXTAUTH_URL=http://localhost:3000 OKTA_OAUTH2_CLIENT_ID={OKTA APPLICATION CLIENT ID} OKTA_OAUTH2_CLIENT_SECRET={OKTA APPLICATION SECRET} OKTA_OAUTH2_ISSUER=https://{YOUR OKTA ACCOUNT URL (click top right and it will appear below your email)} SECRET=Some long random string