feat: update pr preview workflow with correct base url and deployment logic

Author: AritraDey-Dev

.github/workflows/publish-docs.yml

@@ -2,9 +2,11 @@ name: Publish Docs
 
 on:
   push:
-    branches: [master]
+    branches:
+      - master
   pull_request:
-    branches: [master]
+    branches:
+      - master
   workflow_dispatch:
     inputs:
       pr_number:
@@ -31,8 +33,25 @@ jobs:
       - name: Install dependencies
         run: npm ci
 
+      - name: Determine Base URL
+        id: base-url
+        run: |
+          REPO_NAME="${{ github.event.repository.name }}"
+          OWNER="${{ github.repository_owner }}"
+          
+          # Check if it's an org page (owner.github.io)
+          if [[ "${REPO_NAME,,}" == "${OWNER,,}.github.io" ]]; then
+            BASE_PATH="/"
+          else
+            BASE_PATH="/$REPO_NAME/"
+          fi
+          
+          echo "base_path=$BASE_PATH" >> $GITHUB_OUTPUT
+
       - name: Build
         run: npm run build
+        env:
+          BASE_URL: ${{ steps.base-url.outputs.base_path }}
 
       - name: Upload build artifact
         uses: actions/upload-artifact@v4
@@ -46,36 +65,51 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
+        with:
+          ref: refs/pull/${{ inputs.pr_number }}/head
 
-      - name: Find latest run ID
-        id: find-run
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Determine Base URL
+        id: base-url
         run: |
-          BRANCH=$(gh pr view ${{ inputs.pr_number }} --json headRefName --jq .headRefName)
-          echo "Found branch: $BRANCH"
-          RUN_ID=$(gh run list --workflow "Publish Docs" --branch "$BRANCH" --event pull_request --status success --limit 1 --json databaseId --jq '.[0].databaseId')
-          echo "Found run ID: $RUN_ID"
-          if [ -z "$RUN_ID" ]; then
-            echo "::error::No successful 'Publish Docs' run found for PR #${{ inputs.pr_number }} (branch: $BRANCH)"
-            exit 1
+          REPO_NAME="${{ github.event.repository.name }}"
+          OWNER="${{ github.repository_owner }}"
+          PR_NUM="${{ inputs.pr_number }}"
+          
+          # Check if it's an org page (owner.github.io)
+          if [[ "${REPO_NAME,,}" == "${OWNER,,}.github.io" ]]; then
+            BASE_PATH="/pr-$PR_NUM/"
+            FULL_URL="https://$OWNER.github.io/pr-$PR_NUM/"
+          else
+            BASE_PATH="/$REPO_NAME/pr-$PR_NUM/"
+            FULL_URL="https://$OWNER.github.io/$REPO_NAME/pr-$PR_NUM/"
           fi
-          echo "run_id=$RUN_ID" >> $GITHUB_OUTPUT
+          
+          echo "base_path=$BASE_PATH" >> $GITHUB_OUTPUT
+          echo "full_url=$FULL_URL" >> $GITHUB_OUTPUT
 
-      - name: Download build artifact
-        uses: actions/download-artifact@v4
-        with:
-          name: site
-          path: site
-          run-id: ${{ steps.find-run.outputs.run_id }}
-          github-token: ${{ secrets.GITHUB_TOKEN }}
+      - name: Build
+        run: npm run build
+        env:
+          BASE_URL: ${{ steps.base-url.outputs.base_path }}
 
       - name: Deploy PR Preview
         uses: JamesIves/github-pages-deploy-action@v4
         with:
-          branch: gh-pages-pr-previews
-          folder: site
+          token: ${{ secrets.GITHUB_TOKEN }}
+          branch: gh-pages
+          folder: build
           target-folder: pr-${{ inputs.pr_number }}
+          clean: true
+          git-config-name: github-actions[bot]
+          git-config-email: github-actions[bot]@users.noreply.github.com
 
       - name: Comment Preview URL
         uses: marocchino/sticky-pull-request-comment@v2
@@ -86,10 +120,10 @@ jobs:
             🚀 **Preview Ready!**
             Your docs preview for this PR is available here:
 
-            **https://${{ github.repository_owner }}.github.io/${{ github.event.repository.name }}/pr-${{ inputs.pr_number }}/**
+            **${{ steps.base-url.outputs.full_url }}**
 
   deploy-production:
-    if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/master' }}
+    if: ${{ github.event_name == 'push' }}
     runs-on: ubuntu-latest
     needs: build
     steps: