mvp-1-collab-board

Realtime collaborative whiteboard MVP built for the Gauntlet Cohort challenge.

Live deployment: https://mvp-1-collab-board.web.app/b/mvp-demo-board

Loom demo: https://www.loom.com/share/b2016cdf9d4a4b4e96fec12253fec0d9

What This Project Includes

• Multi-user collaborative board with cursor/object sync.
• Frontend app built with React + Vite + TypeScript.
• Firebase backend for Hosting, Auth, Firestore, Realtime Database, and Cloud Functions.
• E2E testing flow with Playwright.

Repository Structure

mvp-1-collab-board/
├── app/              # React client (Vite, TypeScript, Konva)
├── functions/        # Firebase Cloud Functions API
├── scripts/          # QA and deployment helper scripts
├── docs/             # All project documentation
├── tests/            # Test evidence and outputs
├── submission/       # Deliverable artifacts (PDFs, videos)
├── Sessions/         # Transcript archives
└── thoughts/         # Research notes and spikes

Root files:

• README.md — this file
• AGENTS.md — Agent protocol and workflow instructions
• TASKS.md — Active sprint and backlog tracking
• ARCHIVE.md — Historical task ledger and prior evidence snapshots

Local Development

1) Install dependencies

cd app && npm install
cd ../functions && npm install

2) Configure Firebase project

cp .firebaserc.example .firebaserc
# set dev/prod project ids in the aliases map
# default and dev should point to your dev project
# prod should point to your production project

3) Run frontend locally

cd app
npm run dev

4) Build and deploy with environment split

cd app && npm run build
cd ..
bash scripts/deploy-dev.sh

Production deploy runs via GitHub Actions on main. Manual production deploy is explicit:

git switch main
ALLOW_PROD_DEPLOY=1 bash scripts/deploy-prod.sh

5) Test local and prod separately

• Local UI: cd app && npm run dev (default local URL http://127.0.0.1:5173)
• Local backend target: set VITE_AI_API_BASE_URL_DEV in app/.env.local
• Production UI: https://mvp-1-collab-board.web.app
• Production backend target: set VITE_AI_API_BASE_URL_PROD for production builds

Quality Gates

• Fast dev gate (default while coding, no tests): bash scripts/run-dev-gate.sh
• Full pre-prod gate (parallelized checks + sharded Playwright): bash scripts/run-full-gate.sh
• Optional critical backend checks in full gate: RUN_CRITICAL_CHECKS=1 bash scripts/run-full-gate.sh
• Critical backend checks: bash scripts/run-critical-checks.sh
• Submission QA: bash scripts/run-submission-qa.sh

Documentation

Doc	Purpose
docs/PRESEARCH.md	Phase 1-3 research checklist
docs/PRD.md	Product requirements
docs/MVP.md	Minimum viable feature set
docs/DECISIONS.md	Defendable technical decisions
docs/DEMO_SCRIPT.md	3-5 min demo walkthrough
docs/AI_DEVELOPMENT_LOG.md	1-page AI tool usage log
docs/AI_COST_ANALYSIS.md	Dev spend + user projections
docs/DOCUMENTATION.md	Architecture overview