Testing Checklist
Use this checklist to verify your site works correctly before and after deployment.
Pre-Deployment Testing (Local)
Setup Verification
- Ruby is installed (
ruby --version) - Jekyll is installed (
jekyll --version) - Dependencies installed (
bundle installcompleted successfully) - Local server starts (
bundle exec jekyll serve)
Site Structure
- Homepage loads (
http://localhost:4000) - All navigation links work
- All pages exist and load
- No 404 errors
Content
- All text content is correct
- No placeholder text remains
- Images load correctly
- Images are optimized (not too large)
- All links work (internal and external)
Design
- Styling matches Squarespace site
- Colors are correct
- Fonts are correct
- Layout looks good on desktop
- Layout looks good on tablet
- Layout looks good on mobile
- Navigation menu works on mobile
Contact Form
- Form displays correctly
- All form fields are present
- Form validation works (required fields)
- Formspree endpoint is configured
- Test submission works
- Success message displays
- Error handling works
Technical
- No console errors in browser
- No broken image links
- No broken CSS/JS links
- Site loads quickly
- Meta tags are correct (title, description)
Post-Deployment Testing (GitHub Pages)
Initial Deployment
- Repository is created on GitHub
- Code is pushed to GitHub
- GitHub Pages is enabled
- Site builds successfully (check Actions tab)
- Site is accessible at GitHub Pages URL
Functionality
- Homepage loads on GitHub Pages
- All pages load correctly
- Navigation works
- Contact form works in production
- Images load correctly
- All links work
Custom Domain (After DNS Migration)
- CNAME file is in repository
- Custom domain is configured in GitHub
- DNS records are set correctly
www.lahave.ioloads correctlylahave.ioredirects or loads correctly- SSL certificate is active (HTTPS works)
- No mixed content warnings
Cross-Browser Testing
- Chrome/Edge
- Firefox
- Safari
- Mobile browsers (iOS Safari, Chrome Mobile)
Performance
- Page load time is acceptable
- Images are optimized
- No large unoptimized files
- Site works on slow connections
SEO
- Page titles are unique and descriptive
- Meta descriptions are present
- Headings are properly structured (h1, h2, etc.)
- Alt text on images
- Sitemap is generated (if using jekyll-sitemap plugin)
Common Issues to Check
Build Errors
- Check GitHub Actions for build errors
- Verify
_config.ymlis valid YAML - Check for syntax errors in templates
DNS Issues
- DNS has propagated (use whatsmydns.net)
- All 4 A records are set
- CNAME record is correct
- Wait 24-48 hours if recently changed
Form Issues
- Formspree endpoint is correct
- Form action URL is correct
- Check Formspree dashboard for submissions
- Verify email notifications work
Styling Issues
- CSS file loads correctly
- No missing styles
- Responsive design works
- Check browser console for CSS errors
Final Verification
Before going live:
- All content migrated from Squarespace
- Site matches Squarespace design
- All functionality works
- Contact form tested and working
- Mobile responsive
- No broken links
- Performance is acceptable
- Ready for DNS migration
Post-Launch Monitoring
First 48 hours:
- Monitor site accessibility
- Check contact form submissions
- Monitor for errors
- Verify DNS propagation globally
- Test from different locations/networks
Rollback Plan
If issues arise:
- Document the problem
- Revert DNS if necessary
- Fix issues in local environment
- Test locally
- Redeploy
- Update DNS again when ready