feat: monorepo, E2E coverage, live pipeline, database setup, Vercel deployment

.env.example

@@ -5,11 +5,16 @@
 VITE_SUPABASE_URL=your_supabase_project_url_here
 VITE_SUPABASE_ANON_KEY=your_supabase_anon_key_here
 
+# Lighthouse CI Test Credentials (for local testing only)
+LIGHTHOUSE_TEST_EMAIL=your_lighthouse_test_email@example.com
+LIGHTHOUSE_TEST_PASSWORD=your_lighthouse_test_password
+
 # Instructions:
 # 1. Get your Supabase URL and anon key from https://supabase.com/dashboard
 # 2. Go to your project > Settings > API
 # 3. Copy the "URL" and "anon public" key
 # 4. Replace the placeholder values above with your actual keys
-# 5. Save this file as .env.local (not .env.example)
+# 5. Create a test account for Lighthouse CI and add credentials above
+# 6. Save this file as .env.local (not .env.example)
 
 # Note: Never commit .env.local to git - it contains secrets!

.github/workflows/ci.yml

@@ -1,104 +1,213 @@
-name: CI/CD Pipeline
-
-on:
-  push:
-    branches: [main, dev]
-  pull_request:
-    branches: [main, dev]
-
-jobs:
-  test:
-    name: Run Tests
-    runs-on: ubuntu-latest
-
-    env:
-      # Environment variables to help with jsdom compatibility
-      NODE_OPTIONS: --experimental-vm-modules
-      FORCE_COLOR: 0
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: "22"
-          cache: "npm"
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Run linting
-        run: npm run lint
-
-      - name: Run tests
-        run: npm run test
-
-      - name: Generate test coverage
-        run: npm run test:coverage
-
-  build:
-    name: Build Application
-    runs-on: ubuntu-latest
-    needs: test # This ensures build only runs if tests pass
-
-    env:
-      NODE_OPTIONS: --experimental-vm-modules
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: "22"
-          cache: "npm"
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Build application
-        run: npm run build
-
-      - name: Upload build artifacts
-        uses: actions/upload-artifact@v4
-        with:
-          name: build-files
-          path: dist/
-
-  deploy:
-    name: Deploy to Vercel Production
-    runs-on: ubuntu-latest
-    needs: test # This ensures deployment only runs if tests pass
-    if: github.ref == 'refs/heads/main' # Only deploy from main branch
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Deploy to Vercel
-        uses: amondnet/vercel-action@v25
-        with:
-          vercel-token: ${{ secrets.VERCEL_TOKEN }}
-          vercel-org-id: ${{ secrets.VERCEL_ORG_ID }}
-          vercel-project-id: ${{ secrets.VERCEL_PROJECT_ID }}
-          vercel-args: "--prod"
-
-  deploy-preview:
-    name: Deploy to Vercel Preview
-    runs-on: ubuntu-latest
-    needs: test # This ensures deployment only runs if tests pass
-    if: github.ref == 'refs/heads/dev' || github.event.pull_request.head.ref == 'dev' # Deploy preview from dev branch or PRs from dev
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Deploy to Vercel Preview
-        uses: amondnet/vercel-action@v25
-        with:
-          vercel-token: ${{ secrets.VERCEL_TOKEN }}
-          vercel-org-id: ${{ secrets.VERCEL_ORG_ID }}
-          vercel-project-id: ${{ secrets.VERCEL_PROJECT_ID }}
+name: CI/CD Pipeline
+
+on:
+  push:
+    branches: [main, dev]
+  pull_request:
+    branches: [main, dev]
+
+jobs:
+  # ─────────────────────────────────────────────
+  # 1. Unit & component tests (Vitest — apps/web)
+  # ─────────────────────────────────────────────
+  test:
+    name: Unit Tests (apps/web)
+    runs-on: ubuntu-latest
+
+    env:
+      NODE_OPTIONS: --experimental-vm-modules
+      FORCE_COLOR: 0
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: "npm"
+
+      - name: Install dependencies (workspace root)
+        run: npm ci
+
+      - name: Run linting (all workspaces)
+        run: npm run lint --workspace=apps/web
+
+      - name: Run unit tests
+        run: npm run test --workspace=apps/web
+
+      - name: Generate coverage report
+        run: npm run test:coverage --workspace=apps/web
+
+      - name: Upload coverage artifact
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: coverage-report
+          path: apps/web/coverage/
+          retention-days: 7
+
+  # ─────────────────────────────────────────────
+  # 2. Build (apps/web)
+  # ─────────────────────────────────────────────
+  build:
+    name: Build (apps/web)
+    runs-on: ubuntu-latest
+    needs: test
+
+    env:
+      NODE_OPTIONS: --experimental-vm-modules
+      # Provide stub env vars so Vite build doesn't fail on missing Supabase config
+      VITE_SUPABASE_URL: ${{ secrets.VITE_SUPABASE_URL || 'https://placeholder.supabase.co' }}
+      VITE_SUPABASE_ANON_KEY: ${{ secrets.VITE_SUPABASE_ANON_KEY || 'placeholder-anon-key' }}
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: "npm"
+
+      - name: Install dependencies (workspace root)
+        run: npm ci
+
+      - name: Build web app
+        run: npm run build --workspace=apps/web
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: web-build
+          path: apps/web/dist/
+          retention-days: 7
+
+  # ─────────────────────────────────────────────
+  # 3. Playwright E2E tests (e2e workspace)
+  # ─────────────────────────────────────────────
+  e2e:
+    name: Playwright E2E Tests
+    runs-on: ubuntu-latest
+    needs: build
+
+    env:
+      # Provide enough config so the Vite dev server starts
+      VITE_SUPABASE_URL: https://placeholder.supabase.co
+      VITE_SUPABASE_ANON_KEY: placeholder-anon-key
+      CI: true
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: "npm"
+
+      - name: Install dependencies (workspace root)
+        run: npm ci
+
+      - name: Install Playwright browsers
+        run: npx playwright install --with-deps chromium
+        working-directory: e2e
+
+      - name: Run Playwright tests
+        run: npm run test --workspace=e2e
+        env:
+          BASE_URL: http://localhost:5173
+
+      - name: Upload Playwright HTML report
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: playwright-report
+          path: e2e/playwright-report/
+          retention-days: 14
+
+      - name: Upload Playwright test results (screenshots & videos)
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: playwright-test-results
+          path: e2e/test-results/
+          retention-days: 14
+
+      - name: Upload visual regression snapshots
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: visual-regression-snapshots
+          path: e2e/tests/**/*-snapshots/
+          retention-days: 14
+
+  # ─────────────────────────────────────────────
+  # 4. Type-check live-bridge service
+  # ─────────────────────────────────────────────
+  typecheck-bridge:
+    name: Type Check (services/live-bridge)
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: "npm"
+
+      - name: Install dependencies (workspace root)
+        run: npm ci
+
+      - name: Type-check live-bridge
+        run: npx tsc --noEmit
+        working-directory: services/live-bridge
+
+  # ─────────────────────────────────────────────
+  # 6. Deploy to Vercel (Production — main branch)
+  # ─────────────────────────────────────────────
+  deploy:
+    name: Deploy to Vercel Production
+    runs-on: ubuntu-latest
+    needs: [test, e2e]
+    if: github.ref == 'refs/heads/main'
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Deploy to Vercel
+        uses: amondnet/vercel-action@v25
+        with:
+          vercel-token: ${{ secrets.VERCEL_TOKEN }}
+          vercel-org-id: ${{ secrets.VERCEL_ORG_ID }}
+          vercel-project-id: ${{ secrets.VERCEL_PROJECT_ID }}
+          vercel-args: "--prod"
+          # Root directory is configured in Vercel dashboard as apps/web
+          # vercel.json lives at apps/web/vercel.json
+
+  # ─────────────────────────────────────────────
+  # 7. Deploy to Vercel (Preview — dev branch / PRs)
+  # ─────────────────────────────────────────────
+  deploy-preview:
+    name: Deploy to Vercel Preview
+    runs-on: ubuntu-latest
+    needs: [test, e2e]
+    if: github.event_name == 'pull_request'
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Deploy to Vercel Preview
+        uses: amondnet/vercel-action@v25
+        with:
+          vercel-token: ${{ secrets.VERCEL_TOKEN }}
+          vercel-org-id: ${{ secrets.VERCEL_ORG_ID }}
+          vercel-project-id: ${{ secrets.VERCEL_PROJECT_ID }}