Refactor preview deployment workflow for improved clarity and functionality

Author: devnomadic

.github/workflows/preview-deploy.yml

@@ -1,9 +1,9 @@
-name: Build and Deploy Live Preview
+name: Build Preview for Testing
 
 on:
   pull_request:
     branches:
-      - master
+      - main
     types: [opened, synchronize, reopened, closed]
   push:
     branches:
@@ -13,20 +13,11 @@ on:
 permissions:
   contents: read
   pull-requests: write
-  pages: write
-  id-token: write
 
 jobs:
   build-preview:
     runs-on: ubuntu-latest
     if: github.event.action != 'closed'
-    environment:
-      name: github-pages-preview
-      url: https://devnomadic.github.io/preview/${{ steps.branch-info.outputs.branch-name }}/
-    permissions:
-      contents: read
-      pages: write
-      id-token: write
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -52,47 +43,50 @@ jobs:
           
       - name: Build with Jekyll for preview
         run: |
-          # Update baseurl for preview deployment
-          sed -i 's|baseurl: ""|baseurl: "/preview/${{ steps.branch-info.outputs.branch-name }}"|' _config.yml
           bundle exec jekyll build --destination ./_site
         env:
           JEKYLL_ENV: production
 
-      - name: Setup Pages for preview
-        id: pages-preview
-        uses: actions/configure-pages@v4
-        
-      - name: Create preview directory structure
-        run: |
-          mkdir -p preview-site/preview/${{ steps.branch-info.outputs.branch-name }}
-          cp -r _site/* preview-site/preview/${{ steps.branch-info.outputs.branch-name }}/
-          
       - name: Upload preview artifact
         uses: actions/upload-artifact@v4
         with:
           name: preview-site-${{ steps.branch-info.outputs.branch-name }}
-          path: preview-site/
+          path: ./_site
           retention-days: 7
 
-      - name: Comment on PR with preview URL
+      - name: Comment on PR with preview info
         if: github.event_name == 'pull_request'
         uses: actions/github-script@v7
         with:
           script: |
             const { owner, repo } = context.repo;
             const prNumber = context.issue.number;
-            const previewUrl = `https://${owner}.github.io/${repo}/preview/pr-${prNumber}/`;
+            const runId = context.runId;
+            const branchName = "${{ steps.branch-info.outputs.branch-name }}";
             
             github.rest.issues.createComment({
               owner,
               repo,
               issue_number: prNumber,
-              body: `🚀 **Live Preview Ready!**
+              body: `🚀 **Preview Build Complete!**
+              
+              Your preview has been built successfully and is ready for testing.
+              
+              **Download & Test Locally:**
+              1. Go to [Actions Run #${runId}](https://github.com/${owner}/${repo}/actions/runs/${runId})
+              2. Download the \`preview-site-${branchName}\` artifact
+              3. Extract and serve: \`cd extracted-folder && python3 -m http.server 8000\`
+              4. Open http://localhost:8000 in your browser
               
-              Your preview is now live at: **${previewUrl}**
+              💡 **Quick Test Command:**
+              \`\`\`bash
+              # After downloading and extracting:
+              python3 -m http.server 8000
+              # Then open: http://localhost:8000
+              \`\`\`
               
-              📝 This preview will be updated automatically when you push new commits to this PR.
-              🗑️ The preview will be cleaned up when the PR is merged or closed.`
+              � This preview updates automatically with each commit to this PR.`
+            });
 
   cleanup-preview:
     runs-on: ubuntu-latest