Refactor: Implement proper peaceiris deployment strategy

Research-based implementation using peaceiris/actions-gh-pages with
proper separation of concerns for multi-branch deployment.

Key Changes:
- Split deployment into two separate jobs (deploy-develop & deploy-main)
- Develop branch: Uses destination_dir with keep_files to only update /development/
- Main branch: Preserves /development/ folder before deploying to root
- Both use peaceiris/actions-gh-pages@v4 for reliable deployment

How it works:
1. Develop branch pushes trigger deploy-develop job
   - Deploys to destination_dir: development
   - keep_files: true preserves all other files
   - Only /development/ folder is updated

2. Main branch pushes trigger deploy-main job
   - Preserves existing /development/ folder first
   - Deploys entire site to root with keep_files: false
   - Restores /development/ folder after deployment

Based on research from:
- https://tigeroakes.com/posts/til-github-pages-two-branches-github-actions/
- https://github.com/peaceiris/actions-gh-pages

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: hackall360

.github/workflows/deploy.yml

@@ -150,20 +150,14 @@ jobs:
               body: `${icon} **${message}**\n\n**Built with:** Vite\n**Status:** ${status.toUpperCase()}`
             });
 
-  # Job 4b: Deploy to GitHub Pages
-  deploy:
-    name: Deploy to GitHub Pages
+  # Job 4b: Deploy to GitHub Pages (Develop Branch)
+  deploy-develop:
+    name: Deploy to /development/
     needs: build
     runs-on: ubuntu-latest
-    if: needs.build.outputs.build_status == 'success'
+    if: needs.build.outputs.build_status == 'success' && github.ref_name == 'develop'
 
     steps:
-      - name: Checkout gh-pages branch
-        uses: actions/checkout@v4
-        with:
-          ref: gh-pages
-          path: gh-pages-repo
-
       - name: Download build artifact
         uses: actions/download-artifact@v4
         with:
@@ -175,79 +169,90 @@ jobs:
           cd artifact
           tar -xf artifact.tar
           mkdir -p ../dist
-          mv -f * ../dist/ 2>/dev/null || true
+          mv * ../dist/ 2>/dev/null || true
           cd ..
           rm -rf artifact
 
-      - name: Determine deployment path and update files
-        id: deploy-path
+      - name: Deploy to /development/ subdirectory
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./dist
+          destination_dir: development
+          keep_files: true
+          user_name: 'github-actions[bot]'
+          user_email: 'github-actions[bot]@users.noreply.github.com'
+          commit_message: 'Deploy develop branch to /development/'
+
+      - name: Report deployment success
         run: |
-          if [ "${{ github.ref_name }}" == "develop" ]; then
-            echo "📍 Deploying develop branch to /development/ subdirectory"
-            echo "url=https://www.unityailab.com/development/" >> $GITHUB_OUTPUT
+          echo "🚀 DEPLOYMENT SUCCESSFUL"
+          echo "================================"
+          echo "Branch: develop"
+          echo "URL: https://www.unityailab.com/development/"
+          echo "Built with: Vite (optimized)"
+          echo "================================"
+
+  # Job 4c: Deploy to GitHub Pages (Main Branch)
+  deploy-main:
+    name: Deploy to Root
+    needs: build
+    runs-on: ubuntu-latest
+    if: needs.build.outputs.build_status == 'success' && (github.ref_name == 'main' || github.ref_name == 'master')
 
-            # Remove old development folder and copy new build
-            rm -rf gh-pages-repo/development
-            mkdir -p gh-pages-repo/development
-            cp -r dist/* gh-pages-repo/development/
+    steps:
+      - name: Checkout gh-pages branch
+        uses: actions/checkout@v4
+        with:
+          ref: gh-pages
+          path: gh-pages-backup
 
-            echo "✅ Updated /development/ folder only"
+      - name: Preserve /development/ folder
+        run: |
+          if [ -d "gh-pages-backup/development" ]; then
+            cp -r gh-pages-backup/development /tmp/development-backup
+            echo "💾 Preserved /development/ folder"
           else
-            echo "📍 Deploying main branch to root directory"
-            echo "url=https://www.unityailab.com/" >> $GITHUB_OUTPUT
-
-            # Preserve CNAME and development folder
-            if [ -f "gh-pages-repo/CNAME" ]; then
-              cp gh-pages-repo/CNAME /tmp/CNAME
-              echo "💾 Preserved CNAME file"
-            fi
-
-            if [ -d "gh-pages-repo/development" ]; then
-              mv gh-pages-repo/development /tmp/development
-              echo "💾 Preserved /development/ folder"
-            fi
-
-            # Clear root and copy new build
-            rm -rf gh-pages-repo/*
-            cp -r dist/* gh-pages-repo/
-
-            # Restore preserved files
-            if [ -f "/tmp/CNAME" ]; then
-              mv /tmp/CNAME gh-pages-repo/CNAME
-              echo "♻️  Restored CNAME file"
-            fi
-
-            if [ -d "/tmp/development" ]; then
-              mv /tmp/development gh-pages-repo/development
-              echo "♻️  Restored /development/ folder"
-            fi
-
-            echo "✅ Updated root files while preserving /development/"
+            echo "ℹ️  No /development/ folder to preserve"
           fi
 
-      - name: Commit and push to gh-pages
+      - name: Download build artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: github-pages
+          path: artifact
+
+      - name: Extract artifact
         run: |
-          cd gh-pages-repo
-          git config user.name 'github-actions[bot]'
-          git config user.email 'github-actions[bot]@users.noreply.github.com'
-          git add -A
+          cd artifact
+          tar -xf artifact.tar
+          mkdir -p ../dist
+          mv * ../dist/ 2>/dev/null || true
+          cd ..
+          rm -rf artifact
 
-          if git diff --staged --quiet; then
-            echo "No changes to deploy"
-          else
-            git commit -m "Deploy from ${{ github.ref_name }} branch - $(date +'%Y-%m-%d %H:%M:%S')"
-            git push origin gh-pages
-            echo "✅ Deployed successfully"
+      - name: Restore /development/ folder to build
+        run: |
+          if [ -d "/tmp/development-backup" ]; then
+            cp -r /tmp/development-backup dist/development
+            echo "♻️  Restored /development/ folder to deployment"
           fi
 
+      - name: Deploy to root directory
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./dist
+          keep_files: false
+          user_name: 'github-actions[bot]'
+          user_email: 'github-actions[bot]@users.noreply.github.com'
+          commit_message: 'Deploy main branch to root'
+
       - name: Report deployment success
         run: |
           echo "🚀 DEPLOYMENT SUCCESSFUL"
           echo "================================"
           echo "Branch: ${{ github.ref_name }}"
-          echo "URL: ${{ steps.deploy-path.outputs.url }}"
+          echo "URL: https://www.unityailab.com/"
           echo "Built with: Vite (optimized)"
           echo "================================"
-          echo ""
-          echo "✨ Your site is now live with the latest updates!"
-          echo "📦 Bundled, minified, and optimized for production"