| name | vercel-ci-integration |
| description | Configure Vercel CI/CD with GitHub Actions, preview deployments, and automated testing.
Use when setting up automated deployments, configuring preview bots,
or integrating Vercel into your CI pipeline.
Trigger with phrases like "vercel CI", "vercel GitHub Actions",
"vercel automated deploy", "CI vercel", "vercel pipeline".
|
| allowed-tools | Read, Write, Edit, Bash(gh:*), Bash(vercel:*) |
| version | 1.18.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| tags | ["saas","vercel","ci-cd","github-actions","automation"] |
| compatibility | Designed for Claude Code, also compatible with Codex and OpenClaw |
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
cat .vercel/project.json
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
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