> ## Documentation Index
> Fetch the complete documentation index at: https://dashtray.mintlify.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Deployment checklist

# 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:

```
[Add notes here]
```

## Deployment Log

| Date       | Version | Deployed By | Status    | Issues | Notes                         |
| ---------- | ------- | ----------- | --------- | ------ | ----------------------------- |
| 2025-01-15 | v1.0.0  | \[name]     | ✅ Success | None   | Initial production deployment |
|            |         |             |           |        |                               |

## Next Deployment

Scheduled for: \_\_\_\_\_\_\_\_\_\_\_\_\_\_\_
Planned changes: \_\_\_\_\_\_\_\_\_\_\_\_\_\_\_


Built with [Mintlify](https://mintlify.com).