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
- GitHub Workflows module (implied automatically when using
--vercel-deploy)
Installation
npx ds-start init my-app --vercel-deploy
# or add to existing project
npx ds-start add vercel-deployUsing --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:
| Variable | Description |
|---|---|
VERCEL_TOKEN | Vercel API token |
VERCEL_ORG_ID | Vercel organization ID |
VERCEL_PROJECT_ID | Vercel project ID |
Setup
- Install the Vercel CLI:
npm i -g vercel - Link your project:
vercel link - Copy the org and project IDs from
.vercel/project.json - Add
VERCEL_TOKEN,VERCEL_ORG_ID, andVERCEL_PROJECT_IDas 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.