Deployment, CI/CD, monitoring, and production operations for RunSmart PWA. Covers Vercel deployment, environment management, performance monitoring, error tracking, and production incident response. Use when deploying, configuring infrastructure, or troubleshooting production issues.
| Layer | Service | Purpose |
|---|---|---|
| Hosting | Vercel | Next.js deployment, edge functions |
| Database | IndexedDB (client) | Local-first data persistence |
| AI API | OpenAI via Vercel AI SDK | Chat, plan generation |
| Analytics | Vercel Analytics / Web Vitals | Performance monitoring |
| Error Tracking | Console + Vercel Logs | Error reporting |
| PWA |
| next-pwa / Service Worker |
| Offline support, install prompt |
npm run lint — zero warningsnpx tsc --noEmit — zero type errorsnpm run test -- --run — all tests passnpm run build — clean production buildnpx next build --analyze (if configured)# Preview deployment (PR-based)
git push origin feature/branch-name
# Vercel auto-deploys preview
# Production deployment
git push origin main
# Vercel auto-deploys to production
# Required for production
OPENAI_API_KEY=sk-... # AI features
NEXT_PUBLIC_APP_URL=https://runsmart.app
# Optional
VERCEL_ANALYTICS_ID=... # Vercel Analytics
SENTRY_DSN=... # Error tracking (if added)
public/manifest.json with app name, icons, theme| Metric | Target | Tool |
|---|---|---|
| LCP | < 2.5s | Lighthouse |
| FID | < 100ms | Web Vitals |
| CLS | < 0.1 | Web Vitals |
| TTI | < 3.5s | Lighthouse |
| Bundle (JS) | < 200KB gzip | next build |
| PWA Score | 100 | Lighthouse |
Create an agent team for production release:
- Build agent: full production build, fix any errors
- Test agent: run all test suites, report failures
- Deploy agent: verify Vercel config, environment vars, deploy
- Monitor agent: check post-deploy health, logs, performance
V0/next.config.ts, V0/package.jsonV0/public/manifest.json, service worker config.env.local, Vercel dashboard