IProtect

Requirements

• nvm
• node v16.8
• yarn v1.22
• Docker Desktop

Setup

1. yarn setup
2. modules/backend
   1. Copy .env.sample to .env
   2. yarn db:setup
   3. yarn db:start
   4. yarn db:reset
   5. yarn db:seed
   6. yarn start
3. modules/frontend
   1. Copy /env/.env.sample to /env/.env.local
   2. yarn start

Updating APIs

Whenever you make changes to the API on the backend, the interface on the frontend also needs to be updated. The project uses a combination of Swagger to generate the OpenAPI specifications, and swagger-typescript-api to generate the frontend client.

1. Make changes to API
2. Start your server and navigate to localhost:4000/swagger/docs
3. Test your API and ensure it's running correctly
4. Navigate to modules/frontend and run yarn build:api-client
5. The frontend API client should contain the new endpoint

Configuring new project

• You must manually seed the first user

{
   "id": "uuidv4",
   "providerId": "[email protected]",
   "provider": "google-oauth2",
   "name": "IProtect"
}

1. AWS WAF > IPSets
2. Create an IPSet for both IPv4 & IPv6
3. You must enter a description
4. Copy / paste both name and id into project creation
5. Create a new IAM user and enter AWS key / secret