el-foundation/hatch-surf
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
c006d03075
hatch-surf/docs/engineering/deployment-checklist.md
Riley Zhang c006d03075 feat(site): integrate landing page redesign source code into repository 
- Update deployment scripts to use Docker with static files baked in
- Remove host volume mount in favor of self-contained Docker image
- Add verification script to ensure correct content is deployed
- Update documentation to reflect new deployment architecture
- Ensure build process produces correct output without manual copying

Closes ELF-268

Co-Authored-By: Paperclip <noreply@paperclip.ing>
2026-06-25 03:41:14 +02:00

1.9 KiB
Raw Blame History

Deployment Checklist

Quick reference for deploying the hatch.surf homepage.

Pre-Deployment

  • Changes are in site/ directory
  • All assets load locally
  • No console errors in browser
  • Mobile responsive design works

Deployment Methods

1. Automated (Recommended)

Push to main branch:

git push origin main

GitHub Actions will automatically:

  • Deploy to GitHub Pages
  • Build Docker image and deploy to hatch.surf server

2. Manual (From Remote Machine)

# Dry run first
./scripts/deploy-site.sh --dry-run

# Deploy
./scripts/deploy-site.sh

3. Docker Commands (On Server)

# Build image
docker build -t hatch-homepage:latest ./site

# Run container
docker run -d \
  --name hatch-homepage \
  --restart unless-stopped \
  -p 127.0.0.1:3000:80 \
  hatch-homepage:latest

# Check status
docker ps | grep hatch-homepage

Post-Deployment Verification

  • https://hatch.surf loads (HTTP 200)
  • Anime.js magical background renders
  • Scroll animations work (data-animate attributes)
  • All static assets load:
    • style.css
    • main.js
    • brand/og/default.png
    • Google Fonts (Inter, JetBrains Mono)
  • Mobile viewport works (390px width)
  • No console errors

Troubleshooting

Container Not Running

# Check container status
docker ps -a | grep hatch-homepage

# View logs
docker logs hatch-homepage

# Restart container
docker restart hatch-homepage

Assets Not Loading

# Check files in container
docker exec hatch-homepage ls -la /usr/share/nginx/html/

# Rebuild image
docker build -t hatch-homepage:latest ./site
docker restart hatch-homepage

SSL Issues

Caddy handles TLS automatically. Check Caddy status:

docker ps | grep caddy
docker logs caddy

Related Documentation