Client Side Application

Team Keep

https://docs.google.com/document/d/1T8B3dqA8e5DC0h6G0Ws0U6hV89QJ4xI-6eIYmAf7ti4/edit?usp=sharing

How to Install the Client

After cloning, cd client and then do npm install

Available Scripts

In the project directory, you can run:

Local server-next development

For the server migration stack, run keepid_server_next, keepid_client, and keepid_devportal in separate terminals.

# terminal 1: server-next
cd ../keepid_server_next
docker compose up -d postgres fake-gcs
./mvnw spring-boot:run

# terminal 2: client
cd ../keepid_client
npm start

# terminal 3: developer portal
cd ../keepid_devportal
VITE_API_BASE=http://localhost:7001 npm run dev -- --host 127.0.0.1

Open:

• Client: http://localhost:3000
• Developer portal: http://localhost:5173

The client development build currently talks to http://localhost:7001. Start keepid_server_next on that port unless you are intentionally testing a different backend.

Seeded demo users use password demo-pass:

Username	Role
demo-admin	Admin
demo-worker	Worker
demo-client	Client
demo-developer	Developer portal

npm start

Runs the app in the development mode.
Open http://localhost:3000 to view it in the browser.

The page will reload if you make edits.
You will also see any lint errors in the console.

npm test

Launches the test runner in the interactive watch mode.
See the section about running tests for more information.

npm run build

Builds the app for production to the build folder.
It correctly bundles React in production mode and optimizes the build for the best performance.

The build is minified and the filenames include the hashes.
Your app is ready to be deployed!

See the section about deployment for more information.

npm run cosmos

Starts react-cosmos, accessible at localhost:5000