Production Deployment Checklist
Use this checklist to ensure all steps are completed for a successful production deployment.Pre-Deployment (1-2 days before)
Code Quality
- All unit tests passing
- All integration tests passing
- All e2e tests passing
- Linting checks passing
- Type checking passing
- No console errors or warnings
- Code review completed
- Security audit completed
Environment Setup
- Convex production environment configured
- All Convex environment variables set
- GitHub secrets configured
- GitHub variables configured
- Cloudflare Pages project created
- Cloudflare environment variables set
- Custom domain configured (if applicable)
- SSL certificate active
External Services
- DodoPayments account configured
- DodoPayments webhook URL set
- DodoPayments test mode verified
- Resend account configured
- Email templates tested
- OAuth providers configured (optional)
Documentation
- Deployment guide reviewed
- Runbook updated
- Environment variables documented
- API documentation current
- User documentation updated
Staging Verification
- Staging environment deployed
- Manual testing completed
- Integration testing completed
- Performance testing completed
- Security testing completed
- Stakeholder approval received
Team Preparation
- Deployment window scheduled
- Team notified of deployment
- On-call engineer assigned
- Rollback plan documented
- Communication plan ready
Deployment Day
Pre-Deployment
- Run pre-deployment check script
- Verify all tests passing
- Verify staging environment stable
- Create deployment branch/tag
- Notify team of deployment start
Convex Deployment
- Deploy Convex functions:
npx convex deploy --prod - Verify Convex deployment successful
- Check Convex logs for errors
- Verify cron jobs scheduled
- Test Convex functions manually
Frontend Deployment
- Merge code to main branch
- Push to GitHub:
git push origin main - Monitor GitHub Actions workflow
- Verify build successful
- Verify Cloudflare Pages deployment
Verification
- Run post-deployment verification script
- Test homepage accessibility
- Test HTTPS redirect
- Verify SSL certificate
- Test authentication flow
- Test user registration
- Test password reset
Integration Testing
- Test Stripe integration
- Test GitHub integration
- Test Vercel integration
- Test Google Analytics integration
- Test Plausible integration
- Verify metric synchronization
- Test manual sync functionality
Feature Testing
- Test dashboard creation
- Test widget drag-and-drop
- Test alert creation (Pro+)
- Test AI chat (BYOK)
- Test team invitations
- Test subscription upgrade
- Test data export (Scale+)
- Test API endpoints (Scale+)
Webhook Testing
- Test DodoPayments webhook
- Verify subscription events
- Verify payment events
- Check webhook logs in Convex
- Test webhook retry logic
Performance Testing
- Verify homepage load time < 2s
- Verify dashboard load time < 3s
- Verify API response time < 200ms
- Check Core Web Vitals
- Verify CDN caching working
Security Testing
- Verify HTTPS enforced
- Verify HSTS header present
- Verify CSP headers configured
- Test API authentication
- Test rate limiting
- Verify webhook signatures
Post-Deployment (First 24 hours)
Monitoring
- Set up uptime monitoring
- Configure error tracking
- Set up performance monitoring
- Configure usage analytics
- Set up alert notifications
Verification
- Monitor error logs
- Check error rate < 1%
- Verify response times normal
- Check webhook delivery
- Verify email delivery
- Monitor integration syncs
- Verify cron jobs running
User Testing
- Test with real user account
- Verify onboarding flow
- Test all subscription tiers
- Verify billing flow
- Test team collaboration
- Verify data retention
Communication
- Notify team of successful deployment
- Update status page (if applicable)
- Send deployment summary
- Document any issues
- Update changelog
Post-Deployment (First Week)
Monitoring
- Review error logs daily
- Monitor performance metrics
- Check user feedback
- Review support tickets
- Monitor resource usage
Optimization
- Identify performance bottlenecks
- Optimize slow queries
- Review error patterns
- Update documentation based on issues
- Plan improvements for next release
Documentation
- Document deployment issues
- Update troubleshooting guide
- Update runbook with learnings
- Create post-mortem (if needed)
- Share learnings with team
Rollback Checklist
If issues are detected:Immediate Actions
- Assess severity of issue
- Notify team of potential rollback
- Document the issue
- Attempt quick fix (if possible)
- Make rollback decision
Convex Rollback
- List Convex deployments
- Identify last working deployment
- Execute rollback command
- Verify rollback successful
- Test critical functionality
Frontend Rollback
- Access Cloudflare Pages dashboard
- Find last working deployment
- Execute rollback
- Verify rollback successful
- Test critical functionality
Post-Rollback
- Notify team of rollback
- Update status page
- Investigate root cause
- Create fix plan
- Schedule re-deployment
Sign-Off
Deployment Lead
- Name: _______________
- Date: _______________
- Signature: _______________
Technical Lead
- Name: _______________
- Date: _______________
- Signature: _______________
Product Owner
- Name: _______________
- Date: _______________
- Signature: _______________
Notes
Use this section to document any issues, deviations from the plan, or important observations:Deployment Log
| Date | Version | Deployed By | Status | Issues | Notes |
|---|---|---|---|---|---|
| 2025-01-15 | v1.0.0 | [name] | ✅ Success | None | Initial production deployment |