Deploy Preview

Deploy Vercel previews, check status, view logs, and run Lighthouse audits from your agent.

Setup

Requires VERCEL_TOKEN environment variable. Create one at vercel.com/account/tokens.

Optional: VERCEL_SCOPE for team deployments.

Usage

VERCEL_TOKEN="$VERCEL_TOKEN" ./scripts/deploy-preview.sh <command> [args]

Commands

Command	Description
deploy [path] [--prod]	Deploy preview (or production) and return URL
deploy-branch <path> <branch>	Checkout branch and deploy preview
status <url-or-id>	Check deployment state (QUEUED/BUILDING/READY/ERROR)
logs <url-or-id>	View build logs
audit <preview-url>	Run Lighthouse audit (performance, a11y, SEO, best practices)
list [project-id]	Recent deployments

Examples

# Deploy a preview from current directory
deploy-preview.sh deploy

# Deploy a specific branch
deploy-preview.sh deploy-branch ./my-app feature/new-ui

# Check if it's ready
deploy-preview.sh status dpl_abc123

# Run a performance audit
deploy-preview.sh audit https://my-app-abc123.vercel.app

# View build logs
deploy-preview.sh logs dpl_abc123

# List recent deploys
deploy-preview.sh list

Audit Output

The audit command uses Google PageSpeed Insights API (free, no extra key needed) and returns:

{
  "performance": 0.94,
  "accessibility": 0.98,
  "bestPractices": 1.0,
  "seo": 0.91,
  "fcp": "1.2 s",
  "lcp": "2.1 s",
  "cls": "0.003",
  "tbt": "120 ms"
}

Configuration

Variable	Description	Required
VERCEL_TOKEN	Vercel API token	Yes
VERCEL_SCOPE	Team slug for team deployments	No

Requirements

• Vercel CLI (npm i -g vercel)
• curl, jq