⚠️
Keep credentials safe. Never share passwords in email or chat. If a password is compromised, change it immediately and notify the project owner (samson.sam@excelcaregroup.com.au).

Summary of All Accounts

ServiceLogin EmailWhat It's ForWho Holds It
GitHub samson.sam@excelcaregroup.com.au Access the code repository, view deployment history, manage GitHub Actions Developer (Vamsi)
Google Cloud Console samson.sam@excelcaregroup.com.au View Firebase hosting, Cloud Functions, Firestore, Secret Manager Developer (Vamsi)
Google Cloud Console (Owner) samson.sam@excelcaregroup.com.au Full project ownership β€” billing, IAM, can grant others access Project Owner (Samson)
Firebase Console samson.sam@excelcaregroup.com.au Same as Google Cloud Console β€” Firebase is part of Google Cloud Developer (Vamsi)
Resend (email service) Ask project owner Sends contact form notification emails to admin@excelcaregroup.com.au Project Owner

1. GitHub Account

GitHub is where all the website code is stored. Think of it like Google Drive, but for code β€” every change is saved with a history so you can always undo.

Logging In

  1. Log in with samson.sam@excelcaregroup.com.au and your password.
  2. If prompted for two-factor authentication (2FA), use your authenticator app or SMS code.

Key Things to Know in GitHub

SectionWhere to Find ItWhat You'll Use It For
CodeMain tab at topBrowse files, see recent commits
ActionsTop menu β†’ ActionsWatch deployments run, see if they passed or failed
Settings β†’ SecretsSettings β†’ Secrets and variables β†’ ActionsStore API keys used during deployment (e.g. WIF credentials)
Releases / TagsRight sidebar β†’ ReleasesSee all deployment tags ever pushed
ℹ️
The default branch is develop. All changes should go to develop first. Do not push directly to main unless instructed.

2. Google Cloud Console

Google Cloud Console is the control panel for all the infrastructure that runs the website. Firebase (which hosts the website) is part of Google Cloud.

Logging In

  1. Sign in with samson.sam@excelcaregroup.com.au.
  2. At the top of the page, click the project selector dropdown (next to "Google Cloud").
  3. Choose the project you want to work with:
    • webapp-dev-496513 β€” Development environment
    • webapp-prod-496513 β€” Production environment

Key Sections in Google Cloud Console

SectionHow to Navigate ThereWhat You'll Use It For
Firebase HostingLeft menu β†’ Firebase Hosting, or go to console.firebase.google.comSee deployed versions, rollback to a previous version
Cloud FunctionsLeft menu β†’ Cloud FunctionsView the email function, check logs, see errors
FirestoreLeft menu β†’ Firestore DatabaseView contact form submissions stored in the database
Secret ManagerLeft menu β†’ Secret ManagerUpdate the Resend API key or email addresses
Cloud BuildLeft menu β†’ Cloud Build β†’ HistoryView function build logs when troubleshooting deployment
IAM & AdminLeft menu β†’ IAM & Admin β†’ IAMManage who has access to this project

3. Firebase Console

Firebase Console is a simplified view of Firebase-specific features within Google Cloud.

Logging In

  1. Sign in with samson.sam@excelcaregroup.com.au.
  2. You will see a list of projects. Click either webapp-dev-496513 or webapp-prod-496513.
βœ…
Firebase Console and Google Cloud Console show the same projects β€” they are the same platform. Use whichever is easier to navigate.

4. Resend (Email Service)

Resend is the service that delivers contact form emails to admin@excelcaregroup.com.au. The API key for Resend is stored securely in Google Cloud Secret Manager β€” you do not need to log in to Resend for day-to-day maintenance.

If the Resend API key ever needs to be rotated (e.g. it's compromised):

  1. Log in to resend.com with the project owner's account.
  2. Generate a new API key.
  3. In Google Cloud Console β†’ Secret Manager, update the RESEND_API_KEY secret in both webapp-dev-496513 and webapp-prod-496513. See the GCP & Firebase Console guide for detailed steps.

5. SSH Key for GitHub (Developer Machine)

To push code changes from your computer to GitHub, you need an SSH key linked to the samson.sam@excelcaregroup.com.au GitHub account.

ℹ️
If you are setting up a new computer, you will need to generate a new SSH key and add it to GitHub. This is covered in the Mac setup and Windows setup guides.

To use the correct SSH identity when working with this repo, use the host alias github-excelcare in git commands instead of github.com:

git clone git@github-excelcare:Excel-Care-Group/excelcare-webapp.git
git remote set-url origin git@github-excelcare:Excel-Care-Group/excelcare-webapp.git

This alias is configured in ~/.ssh/config and tells your computer to use the vamsik87 SSH key for this repository. The local setup guides cover how to configure this.