dealplustech-astro/DEPLOYMENT.md

Deployment Guide - Deal Plus Tech Astro Website

📋 Pre-Deployment Checklist

• All pages build successfully (npm run build)
• Images copied to public/images/
• Environment variables configured
• Umami Analytics set up
• Admin password changed from default
• Cookie consent tested
• Mobile responsiveness verified
• SEO meta tags on all pages

🚀 Deployment Steps

Step 1: Initialize Git Repository

cd dealplustech-astro
git init
git add .
git commit -m "Initial commit - Deal Plus Tech migration to Astro"

Step 2: Push to Gitea

# Add remote (replace with your actual Gitea URL)
git remote add origin https://git.moreminimore.com/{username}/dealplustech-astro.git

# Push to main
git push -u origin main

Step 3: Deploy on Easypanel

1. Login to Easypanel: https://panelwebsite.moreminimore.com

2. Create New Project:

   • Project Name: dealplustech
   • Click "Create Project"

3. Create New Service:

   • Service Name: dealplustech-astro
   • Select "Git Repository"
   • Repository: dealplustech-astro
   • Branch: main

4. Configure Build:

   • Build Command: npm run build
   • Output Directory: dist
   • Port: 80
   • Node Version: 20

5. Environment Variables:

   UMAMI_WEBSITE_ID=xxx-xxx-xxx
   ADMIN_PASSWORD=YourSecurePassword123!
   NODE_ENV=production
   

6. Deploy:

   • Click "Deploy"
   • Wait for build to complete (~2-3 minutes)
   • Check deployment status

Step 4: Verify Deployment

1. Check Website:

   • Visit your Easypanel URL
   • Test homepage
   • Test product pages (Thai URLs)
   • Test contact page

2. Test Cookie Consent:

   • Clear browser cookies
   • Reload page
   • Verify consent banner appears
   • Test accept/reject buttons

3. Test Analytics:

   • Accept analytics cookies
   • Check Umami dashboard for visits

4. Mobile Testing:

   • Test on mobile device
   • Verify responsive design
   • Check navigation menu

🔄 Auto-Deploy Workflow

Easypanel auto-deploys on every push to main branch:

# Make changes
git add .
git commit -m "Update product page"
git push

# Easypanel automatically:
# 1. Detects push
# 2. Runs npm install
# 3. Runs npm run build
# 4. Deploys new version
# 5. Shows deployment status

📊 Monitoring

Deployment Status

Check Easypanel dashboard for:

• Build logs
• Deployment status
• Resource usage
• Error logs

Analytics

Check Umami dashboard at: https://analytics.dealplustech.co.th

• Real-time visitors
• Page views
• Referrer sources
• Device breakdown

Consent Logs

Access consent logs: https://dealplustech.co.th/admin/consent-logs

• Login with ADMIN_PASSWORD
• View all consent records
• Export to CSV
• Delete records (right to be forgotten)

🛠️ Maintenance

Update Content

1. Edit Markdown/Files:

   • Blog posts: src/content/blog/
   • Product pages: src/pages/[url]/index.astro

2. Commit and Push:

   git add .
   git commit -m "Update content"
   git push
   

3. Auto-deploy: Wait ~2-3 minutes

Update Dependencies

npm update
npm run build  # Test locally first
git add package.json
git commit -m "Update dependencies"
git push

Database Backup

Consent logs stored in SQLite (or Turso if configured):

# Local backup
cp db/consent.db backup-$(date +%Y%m%d).db

# Production (via Easypanel console)
# Download consent.db file

🐛 Troubleshooting

Build Fails

1. Check logs in Easypanel
2. Test locally: npm run build
3. Common issues:
   • Missing dependencies: npm install
   • Syntax errors: Check recent changes
   • TypeScript errors: npm run check

Page Not Found

1. Verify URL structure matches file path
2. Check Thai URL encoding
3. Clear cache: Hard refresh (Ctrl+Shift+R)

Cookie Consent Not Working

1. Check localStorage: Open DevTools → Application → Local Storage
2. Verify script loading: Check Network tab for errors
3. Test in incognito: Clear all cookies first

Analytics Not Tracking

1. Check Umami Website ID in .env
2. Verify consent given for analytics
3. Check browser console for errors

📈 Performance Optimization

Image Optimization (Recommended)

Convert images to WebP:

# Install sharp
npm install -g sharp-cli

# Convert all images
sharp public/images/**/*.jpg -o public/images/ -f webp -q 80

Enable Compression

Easypanel handles compression automatically.

CDN (Optional)

For better performance:

1. Set up Cloudflare CDN
2. Point DNS to Cloudflare
3. Enable caching
4. Configure page rules

🔐 Security

Environment Variables

• NEVER commit .env file
• Use strong passwords
• Rotate passwords periodically

HTTPS

Easypanel provides HTTPS automatically.

Rate Limiting

Consider adding rate limiting for API endpoints:

// src/pages/api/consent/POST.ts
import rateLimit from 'express-rate-limit';

const limiter = rateLimit({
  windowMs: 15 * 60 * 1000, // 15 minutes
  max: 100 // limit each IP to 100 requests per windowMs
});

📞 Support

Issues?

1. Check Easypanel logs
2. Review Astro docs: https://docs.astro.build
3. Check this guide

Emergency Contact:

• Admin: [Your contact]
• Developer: [Your contact]

---

Last Updated: 2026-03-12
Version: 1.0