ExcelCare Webapp — Maintenance Guide
Everything you need to manage, update, and deploy the ExcelCare Group website.
What Is This Guide?
This guide explains how to look after the ExcelCare Group website. It covers:
- Which accounts and login credentials you need
- How to set up your computer (Mac or Windows) to make changes
- How to test changes locally before they go live
- How to deploy a new version to the live website
- How to use the Google Cloud and Firebase dashboards
Quick Navigation
Accounts & Access
Which email logins you need for GitHub, Google Cloud, and Firebase.
Local Setup — Mac
Install all tools on macOS and run the site on your own computer.
Local Setup — Windows
Install all tools on Windows 10/11 and run the site locally.
Making Changes
Edit text, images, and content; understand the file structure.
Deploying
Push changes to dev or production using the Git tag workflow.
GCP & Firebase
Manage secrets, view logs, and monitor the live site.
DNS & Hostgator
Add or update DNS records for email auth, custom domains, and more.
Email Service
How Resend and Cloud Functions deliver contact form emails.
Owner Admin Guide
SharePoint and Entra ID administration reference for ECG Australia.
Technology Overview
Here is a plain-English summary of each component that makes up the website:
| Component | What it does | Where it lives |
|---|---|---|
| React / Vite frontend | The actual website pages visitors see | client/src/ |
| Firebase Hosting | Serves the website files to visitors globally | Google Cloud — Firebase |
| Cloud Functions | Sends contact-form emails via Resend | functions/src/ |
| Firestore | Database that stores contact form submissions | Google Cloud — Firebase |
| GitHub Actions | Automated pipeline that builds & deploys when you push a tag | .github/workflows/ |
| Resend | Third-party email delivery service (sends form notification emails) | resend.com |
Two Environments
The webapp has two separate deployed environments:
| Environment | URL | GCP Project | Used for |
|---|---|---|---|
| Development | webapp-dev-496513.web.app | webapp-dev-496513 | Testing changes before going live |
| Production | webapp-prod-496513.web.app | webapp-prod-496513 | The real public website |
Who Manages This?
| Platform | Login Email | Role |
|---|---|---|
| GitHub | samson.sam@excelcaregroup.com.au | Repository access (developer) |
| Google Cloud / Firebase | samson.sam@excelcaregroup.com.au | Project access |
| Google Cloud (project owner) | samson.sam@excelcaregroup.com.au | Project Owner |
| Resend (email delivery) | Check with project owner | API key holder |