80 lines
2.6 KiB
Markdown
80 lines
2.6 KiB
Markdown
# Vercel → Cloudflare Pages Migration Checklist
|
|
|
|
## ✅ Completed Setup
|
|
|
|
- [x] Created `_redirects` file for SPA routing (in `src/public/`)
|
|
- [x] Updated `package.json` to remove Vercel from deploy script
|
|
- [x] Created migration guide (`CLOUDFLARE_PAGES_MIGRATION.md`)
|
|
- [x] Updated deployment documentation
|
|
|
|
## 📋 Action Items
|
|
|
|
### 1. Create Cloudflare Pages Project
|
|
- [ ] Go to [Cloudflare Dashboard](https://dash.cloudflare.com/)
|
|
- [ ] Navigate to **Pages** → **Create a project**
|
|
- [ ] Connect GitHub repository: `Jeff-Emmett/canvas-website`
|
|
- [ ] Configure:
|
|
- **Project name**: `canvas-website`
|
|
- **Production branch**: `main`
|
|
- **Build command**: `npm run build`
|
|
- **Build output directory**: `dist`
|
|
- **Root directory**: `/` (leave empty)
|
|
|
|
### 2. Set Environment Variables
|
|
- [ ] Go to Pages project → **Settings** → **Environment variables**
|
|
- [ ] Add all `VITE_*` variables from Vercel:
|
|
- `VITE_WORKER_ENV=production` (for production)
|
|
- `VITE_WORKER_ENV=dev` (for preview)
|
|
- Any other `VITE_*` variables you use
|
|
- [ ] Set different values for **Production** and **Preview** if needed
|
|
|
|
### 3. Test First Deployment
|
|
- [ ] Wait for first deployment to complete
|
|
- [ ] Visit Pages URL (e.g., `canvas-website.pages.dev`)
|
|
- [ ] Test routes:
|
|
- [ ] `/board`
|
|
- [ ] `/inbox`
|
|
- [ ] `/contact`
|
|
- [ ] `/presentations`
|
|
- [ ] `/dashboard`
|
|
- [ ] Verify canvas app connects to Worker
|
|
- [ ] Test real-time collaboration
|
|
|
|
### 4. Configure Custom Domain (if applicable)
|
|
- [ ] Go to Pages project → **Custom domains**
|
|
- [ ] Add your domain (e.g., `jeffemmett.com`)
|
|
- [ ] Update DNS records to point to Cloudflare Pages
|
|
- [ ] Wait for DNS propagation
|
|
|
|
### 5. Clean Up Vercel (after confirming Cloudflare works)
|
|
- [ ] Verify everything works on Cloudflare Pages
|
|
- [ ] Go to Vercel Dashboard
|
|
- [ ] Disconnect repository or delete project
|
|
- [ ] Update DNS records if using custom domain
|
|
|
|
## 🔍 Verification Steps
|
|
|
|
After migration, verify:
|
|
- ✅ All routes work (no 404s)
|
|
- ✅ Canvas app loads and connects to Worker
|
|
- ✅ Real-time collaboration works
|
|
- ✅ Environment variables are accessible
|
|
- ✅ Assets load correctly
|
|
- ✅ No console errors
|
|
|
|
## 📝 Notes
|
|
|
|
- The `_redirects` file is in `src/public/` and will be copied to `dist/` during build
|
|
- Worker deployment is separate and unchanged
|
|
- Environment variables must start with `VITE_` to be accessible in the browser
|
|
- Cloudflare Pages automatically deploys on push to `main` branch
|
|
|
|
## 🆘 If Something Goes Wrong
|
|
|
|
1. Check Cloudflare Pages build logs
|
|
2. Check browser console for errors
|
|
3. Verify environment variables are set
|
|
4. Verify Worker is accessible
|
|
5. Check `_redirects` file is in `dist/` after build
|
|
|