vercel-ci-integration

# Vercel CI Integration ## Overview Set up automated Vercel deployments in GitHub Actions with preview deployments on PRs, production deploys on merge to main, and optional test gating. Covers both Vercel's built-in Git integration and custom CI pipelines using the Vercel CLI. ## Prerequisites - GitHub repository with Actions enabled - Vercel project linked to the repo - `VERCEL_TOKEN` stored as GitHub Secret - `VERCEL_ORG_ID` and `VERCEL_PROJECT_ID` from `.vercel/project.json` ## Instructions ### Step 1: Store CI Secrets in GitHub ```bash # Get project and org IDs cat .vercel/project.json # {"orgId":"team_xxx","projectId":"prj_xxx"} # Add secrets to GitHub repo gh secret set VERCEL_TOKEN --body "your-vercel-token" gh secret set VERCEL_ORG_ID --body "team_xxx" gh secret set VERCEL_PROJECT_ID --body "prj_xxx" ``` ### Step 2: GitHub Actions — Preview on PR ```yaml # .github/workflows/vercel-preview.yml name: Vercel Preview Deployment on: pull_request: branches: [main] jobs: deploy-preview: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - name: Install Vercel CLI run: npm install -g vercel@latest - name: Pull Vercel Environment run: vercel pull --yes --environment=preview --token=${{ secrets.VERCEL_TOKEN }} env: VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }} VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }} - name: Build Project run: vercel build --token=${{ secrets.VE...