Vercel Deploy

Vercel CD pipeline with preview and production deployments.

Overview

Adds a Vercel deployment pipeline for preview and production deployments. Builds on the GitHub Workflows module.

Prerequisites

Installation

npx ds-start init my-app --vercel-deploy
# or add to existing project
npx ds-start add vercel-deploy

Using --vercel-deploy automatically implies --github-workflows.

What It Adds

  • vercel.json — Vercel project configuration
  • .github/workflows/deploy.yml — Deployment workflow

Environment Variables

These are set as GitHub Actions secrets:

VariableDescription
VERCEL_TOKENVercel API token
VERCEL_ORG_IDVercel organization ID
VERCEL_PROJECT_IDVercel project ID

Setup

  1. Install the Vercel CLI: npm i -g vercel
  2. Link your project: vercel link
  3. Copy the org and project IDs from .vercel/project.json
  4. Add VERCEL_TOKEN, VERCEL_ORG_ID, and VERCEL_PROJECT_ID as GitHub Actions secrets

Usage

Once configured, deployments happen automatically:

  • Pull requests → Preview deployment with a unique URL
  • Merge to main → Production deployment

No manual deployment steps required.

On this page