🔥 The Sacred Deployment Codex 🔥

📜 The Golden Path: Update Without Breaking

This codex contains the sacred workflow for safely adding enhancements, seasonal themes, and content updates to the Kypria Technologies Basilica without disrupting DNS or causing downtime.

🛡️ Pre-Flight Checklist (ALWAYS RUN FIRST)

Step 0: Backup DNS State

# Run the DNS backup script
dig kypriatechnologies.org > dns_backup_$(date +%Y%m%d).txt
dig www.kypriatechnologies.org >> dns_backup_$(date +%Y%m%d).txt

Step 1: Verify Current Production State

# Check that site is currently accessible
curl -I https://kypriatechnologies.org

# Expected output should include:
# HTTP/2 200
# server: Netlify

⚙️ The Deployment Workflow

Method 1: Local Development → Git → Netlify (RECOMMENDED)

Step 1: Clone/Pull Latest Code

# If you don't have the repo locally yet
git clone https://github.com/Kypria-LLC/kypria-technologies.git
cd kypria-technologies

# If you already have it, update to latest
git pull origin main

Step 2: Make Changes Locally

# Edit index.html or any other files
nano index.html

# OR use your preferred editor
code index.html

Step 3: Test Locally FIRST (CRITICAL!)

# Serve the site locally
python3 -m http.server 8000

# OR if you have Node.js:
npx http-server -p 8000

# Then visit: http://localhost:8000

Step 4: Commit Changes with Ceremonial Message

# Stage your changes
git add .

# Commit with descriptive message
git commit -m "feat: Add Christmas 2025 seasonal enhancements

- Added snowfall animation
- Updated color scheme to winter theme
- Enhanced festive branding

Tested locally: ✅ All animations working
DNS status: ✅ Verified before deployment"

# Push to GitHub
git push origin main

Step 5: Monitor Netlify Deployment

Visit: Netlify Dashboard

Watch for:

• ✅ Build starts automatically (usually within 10 seconds)
• ✅ Build completes successfully (green checkmark)
• ✅ "Published" status appears

Typical build time: 30-60 seconds

Step 6: Wait for CDN Propagation

Step 7: Verify Production Deployment

# Hard refresh your browser
# Windows/Linux: Ctrl + Shift + R
# Mac: Cmd + Shift + R

# OR use curl to bypass browser cache:
curl -I https://kypriatechnologies.org

🚨 Emergency Rollback Procedure

If deployment breaks the site:

Quick Rollback via Git

# See recent commits
git log --oneline -5

# Revert to previous working commit
git revert HEAD

# Or force rollback to specific commit
git reset --hard [commit-hash-from-git-log]
git push --force origin main

# Netlify will auto-redeploy the old working version

Emergency Rollback via Netlify Dashboard

1. Visit: Netlify Deploys
2. Find last working deploy (green checkmark)
3. Click "..." menu → "Publish deploy"
4. Confirm rollback
5. Site reverts instantly

🛡️ Safety Guardrails

What WILL Trigger Netlify Rebuild (Safe)

• ✅ Push to main branch
• ✅ Edit files via GitHub web UI
• ✅ Merge pull request to main
• ✅ Manual "Trigger deploy" in Netlify dashboard

What Will NOT Break DNS (Safe)

• ✅ Editing HTML/CSS/JS files
• ✅ Adding new files to repo
• ✅ Updating README.md
• ✅ Modifying manifest.json
• ✅ Changing images/assets
• ✅ Updating netlify.toml settings

What CAN Break DNS (DANGER!)

📅 Recommended Update Schedule

🔗 Critical URLs