kids-first / kf-portal-ui

:bar_chart: The Kids First Data Resource Portal and Social Network User Interface

kids-first-portal-ui

Pre-requisites

• Node 16+
• Docker

Get Started

Environment variables:

• Create a .env with the scheme found here: https://github.com/include-dcc/include-portal-ui/blob/main/.env.schema
• Make sure to fill all the variables

Running the project locally

Starting the Bastion

• Start bastion using: igor

Starting the project

• Install dependencies: npm install
• Start the project: npm start

Running the USERS API locally

• Clone: https://github.com/include-dcc/include-users-api
• Follow the steps here: https://github.com/include-dcc/include-users-api/blob/main/README.md
• Make sure to add the include keycloak config for the users-api in your .env

Running the PERSONA API locally

• Clone: https://github.com/kids-first/kf-persona
• Follow the steps here: https://github.com/kids-first/kf-persona#readme
• Make sure to add the REACT_APP_PERSONA_API value to your .env

Running NGINX locally

• Follow the steps here: https://github.com/kids-first/kf-portal-ui/blob/2.0/dev_tools/nginx/README.md

Storybook

Run to install storybook submodules

git submodule init
git submodule update

Branch

Name structure is type/SKFP-[github ticker number]/description

e.g.

"fix/SKFP-23432/issue-with-..."

Supported types:

• build: Changes that affect the build system or external dependencies (example scopes: gulp, broccoli, npm)
• ci: Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs)
• docs: Documentation only changes
• feat: A new feature
• fix: A bug fix
• perf: A code change that improves performance
• refactor: A code change that neither fixes a bug nor adds a feature
• style: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
• test: Adding missing tests or correcting existing tests

Commit

Commit message should follow a customized conventional commits specification

Message structure is type([scope]): #[github ticker number] message

e.g.

"fix(CohortBuild): #23432 Resolve issue with ..."

"feat: #23423 Member can now do ..."

Supported types:

• build: Changes that affect the build system or external dependencies (example scopes: gulp, broccoli, npm)
• ci: Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs)
• docs: Documentation only changes
• feat: A new feature
• fix: A bug fix
• perf: A code change that improves performance
• refactor: A code change that neither fixes a bug nor adds a feature
• style: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
• test: Adding missing tests or correcting existing tests

Deployment

See Documentation

Acknowledgement

Docker

Steps from scratch:

1. Clone this repo
2. Checkout branch 2.0
3. Add a .env file with the required values at the root of the project (based on the .env.schema file)
4. docker-compose up