Environments & Branches

This page documents Pivot's three environments: Development, Staging, and Production. Each environment has its own Firebase project, branch, and deployment URLs.

Environment Overview

Environment	Firebase Project	Branch	Firebase Alias
Development	`pivot-dev-59310`	`development`	`default`
Staging	`pivot-not-production-project`	`main`	`default`
Production	`pivot-inc`	`production`	`production`

URLs by Environment

Development

Purpose	URL
Web App	https://pivot-dev-59310.web.app/signin
Stats Dashboard	https://pivot-dev-59310.web.app/stats
Firebase Console	https://console.firebase.google.com/project/pivot-dev-59310

Staging

Purpose	URL
Web App	https://pivot-not-production-project.web.app/signin
Stats Dashboard	https://pivot-not-production-project.web.app/stats
Firebase Console	https://console.firebase.google.com/project/pivot-not-production-project

Production

Purpose	URL
Web App	https://the.pivotapp.ca/signin
Stats Dashboard	https://the.pivotapp.ca/stats
Firebase Console	https://console.firebase.google.com/project/pivot-inc

Branch Strategy

development (default) → main (staging) → production

Development Branch (`development`)

Default branch for all new work
Feature branches are created from development
Pull requests target development first
Deploys automatically to pivot-dev-59310

Main Branch (`main`)

Staging branch for QA and testing
Changes merged from development after initial testing
Deploys automatically to pivot-not-production-project
Used for final validation before production

Production Branch (`production`)

Production branch - customer-facing
Changes merged from main after staging validation
Deploys automatically to pivot-inc via CI/CD

Stats Dashboard

The Stats Dashboard is available in all environments:

Dev: https://pivot-dev-59310.web.app/stats
Staging: https://pivot-not-production-project.web.app/stats
Production: https://the.pivotapp.ca/stats

Features

View data across different companies
Switch between environments/branches
Monitor key metrics and KPIs

For advanced analytics and KPI dashboards, see the pivot-kpi project which provides:

Stripe data integration via BigQuery
HubSpot sync capabilities
Detailed revenue and subscription metrics

CI/CD Pipeline

Each branch has automatic deployment via GitHub Actions:

Branch	Trigger	Target Project	Actions
`development`	Push/Merge	`pivot-dev-59310`	Build, Test, Deploy
`main`	Push/Merge	`pivot-not-production-project`	Build, Test, Deploy
`production`	Push/Merge	`pivot-inc`	Build, Test, Deploy

Branch Protection

All protected branches require:

1 code review before merging
CI checks to pass (frontend, build-and-test, enforce-coverage)
No force pushes allowed
Admins can bypass for emergencies

Test Accounts (Dev & Staging)

Email	Password
yannickfarmer7@gmail.com	123456

Invitation code: SfYf8080

Troubleshooting

For common deployment issues and their solutions, see the Deployment Troubleshooting Guide in pivot-devops.

Common issues:

Cloud Tasks permission errors - Add roles/cloudtasks.admin to service accounts
1st Gen to 2nd Gen migration - Delete old function before deploying
Wrong project targeted - Check firebase use and verify account

Environment Overview​

URLs by Environment​

Development​

Staging​

Production​

Branch Strategy​

Development Branch (development)​

Main Branch (main)​

Production Branch (production)​

Stats Dashboard​

Features​

Related Projects​

CI/CD Pipeline​

Branch Protection​

Test Accounts (Dev & Staging)​

Troubleshooting​