Preview Deployments for Every Branch — Stakeholders Review Before Merge

# .gitlab-ci.yml
preview-deploy:
  stage: preview
  image: node:20-slim
  script:
    # Install Vercel CLI
    - npm install -g vercel

    # Deploy preview with branch-specific URL
    - |
      DEPLOY_URL=$(vercel deploy \
        --token $VERCEL_TOKEN \
        --scope pyratzlabs \
        --yes \
        --meta gitlabMR=$CI_MERGE_REQUEST_IID \
        2>&1 | grep "https://")

    # Post preview URL as MR comment
    - |
      curl --request POST \
        --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
        "https://gitlab.com/api/v4/projects/$CI_PROJECT_ID/merge_requests/$CI_MERGE_REQUEST_IID/notes" \
        --data-urlencode "body=🚀 **Preview Deployment Ready**

      **URL:** $DEPLOY_URL

      Preview will stay live until the MR is merged or closed.

      | Check | Status |
      |-------|--------|
      | Build | ✅ Passed |
      | Deploy | ✅ Live |
      | Lighthouse | ⏳ Running... |
      | E2E Tests | ⏳ Running... |"

  only:
    - merge_requests
  environment:
    name: preview/$CI_MERGE_REQUEST_IID
    url: $DEPLOY_URL
    on_stop: cleanup-preview

// cypress.config.js — dynamically targets preview URL
const { defineConfig } = require('cypress');

module.exports = defineConfig({
  e2e: {
    baseUrl: process.env.PREVIEW_URL || 'http://localhost:3000',
    specPattern: 'cypress/e2e/**/*.cy.{js,ts}',
    video: true,
    screenshotOnRunFailure: true,
  },
});

# Run E2E tests against the preview
PREVIEW_URL=$DEPLOY_URL npx cypress run --reporter junit --reporter-options mochaFile=results.xml

# Run Lighthouse audit
npx lighthouse $DEPLOY_URL \
  --output=json --output-path=lighthouse.json \
  --chrome-flags="--headless --no-sandbox"

# Parse test results and update the MR comment
PASS_COUNT=$(cat results.xml | grep -c 'status="passed"')
FAIL_COUNT=$(cat results.xml | grep -c 'status="failed"')
LH_SCORE=$(cat lighthouse.json | jq '.categories.performance.score * 100')

curl --request PUT \
  --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
  "https://gitlab.com/api/v4/projects/$CI_PROJECT_ID/merge_requests/$CI_MERGE_REQUEST_IID/notes/$NOTE_ID" \
  --data-urlencode "body=🚀 **Preview Deployment Ready**

**URL:** $DEPLOY_URL

| Check | Status |
|-------|--------|
| Build | ✅ Passed |
| Deploy | ✅ Live |
| E2E Tests | ✅ $PASS_COUNT passed, $FAIL_COUNT failed |
| Lighthouse | ✅ Performance: ${LH_SCORE}/100 |
| Visual Regression | ✅ No changes detected |"

# If all checks pass, auto-approve
approve-mr:
  stage: post-preview
  script:
    - |
      if [ "$QA_STATUS" = "passed" ] && [ "$LIGHTHOUSE_SCORE" -ge 80 ]; then
        curl --request POST \
          --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
          "https://gitlab.com/api/v4/projects/$CI_PROJECT_ID/merge_requests/$CI_MERGE_REQUEST_IID/approve"
        echo "✅ MR auto-approved"
      else
        echo "❌ MR blocked — checks failed"
        exit 1
      fi
  only:
    - merge_requests
  needs: [preview-deploy, run-qa]