# Deployment Workflow

> GitHub commits, Vercel deployments, PWA configuration, and rollback procedures.

- Skill: `majiayu000/deployment-workflow` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/deployment-workflow`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/deployment-workflow/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/deployment-workflow

---


# Deployment Workflow

Complete deployment workflow: GitHub → Vercel → Production.

## When to Use
- Ready to deploy to production
- Creating releases
- PWA updates
- Deployment verification

## Philosophy
**ONE CODEBASE, ALL PLATFORMS**
- Single Next.js app deployed to Vercel
- PWA on phones = the website
- Git push → Vercel auto-deploys → everyone auto-updates

## Quick Deploy
```bash
npm run build && npm version patch && git push origin main
```

## Pre-Deployment Checklist
- [ ] `npm run build` passes
- [ ] `npm run lint` passes
- [ ] Database migrations applied (`supabase db push`)
- [ ] Environment variables set in Vercel
- [ ] PWA icons exist (`ls public/*.png`)

## Version Bump
```bash
npm version patch   # Bug fixes: 1.0.0 → 1.0.1
npm version minor   # Features: 1.0.0 → 1.1.0
npm version major   # Breaking: 1.0.0 → 2.0.0
```

## Rollback Options
1. **Vercel Dashboard** (30s): Deployments → Promote old version
2. **Git Revert** (2min): `git revert HEAD && git push origin main`
3. **Hotfix** (5min): Create hotfix branch, fix, merge, push

## Branch Strategy
- `main` → Production (empathyledger.com)
- `develop` → Staging (preview URL)
- `feature/*` → Feature branches (preview URL)

## Reference Files
| Topic | File |
|-------|------|
| Full checklist | `refs/checklist.md` |

## Related Skills
- `local-dev-server` - Local development
- `supabase-deployment` - Database deployment
- `cultural-review` - Pre-deploy cultural check