Refactor GitHub Pages deployment workflow for Blazor

Author: parsapanahpoor

.github/workflows/pages.yml

@@ -1,4 +1,4 @@
-name: Deploy to GitHub Pages
+name: Deploy Blazor to GitHub Pages
 
 on:
   push:
@@ -19,51 +19,97 @@ concurrency:
   cancel-in-progress: false
 
 jobs:
-  build:
+  build-and-deploy:
     runs-on: ubuntu-latest
 
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    
     steps:
-    - name: Checkout
+    # ========================================
+    # 1️⃣ Checkout Repository
+    # ========================================
+    - name: 📥 Checkout repository
       uses: actions/checkout@v4
 
-    - name: Setup .NET
+    # ========================================
+    # 2️⃣ Setup .NET SDK
+    # ========================================
+    - name: 🔧 Setup .NET 8.0
       uses: actions/setup-dotnet@v4
       with:
         dotnet-version: '8.0.x'
 
-    - name: Restore
+    # ========================================
+    # 3️⃣ Restore NuGet packages
+    # ========================================
+    - name: 📦 Restore dependencies
       run: dotnet restore samples/BlazorWasm.NET8/BlazorWasm.NET8.csproj
 
-    - name: Publish
-      run: dotnet publish samples/BlazorWasm.NET8/BlazorWasm.NET8.csproj -c Release -o release
+    # ========================================
+    # 4️⃣ Publish Blazor WASM
+    # ========================================
+    - name: 🏗️ Publish Blazor WASM
+      run: |
+        dotnet publish samples/BlazorWasm.NET8/BlazorWasm.NET8.csproj \
+          -c Release \
+          -o publish \
+          -p:GHPages=true \
+          -p:BlazorEnableCompression=false
     
-    - name: Change base-tag
-      run: sed -i 's/<base href="\/" \/>/<base href="\/blazor\/" \/>/g' release/wwwroot/index.html
+    # ========================================
+    # 5️⃣ Fix base href for GitHub Pages
+    # ========================================
+    - name: 🔧 Update base href
+      run: |
+        sed -i 's|<base href="/" />|<base href="/Blazor/" />|g' publish/wwwroot/index.html
+        echo "✅ Base href updated to /Blazor/"
     
-    - name: Add .nojekyll
-      run: touch release/wwwroot/.nojekyll
+    # ========================================
+    # 6️⃣ Add .nojekyll file
+    # ========================================
+    - name: 📝 Add .nojekyll
+      run: |
+        touch publish/wwwroot/.nojekyll
+        echo "✅ .nojekyll file created"
     
-    - name: Setup Pages
+    # ========================================
+    # 7️⃣ Add 404 fallback for SPA routing
+    # ========================================
+    - name: 🔄 Create 404.html
+      run: |
+        cp publish/wwwroot/index.html publish/wwwroot/404.html
+        echo "✅ 404.html created for SPA routing"
+    
+    # ========================================
+    # 8️⃣ List published files (for debugging)
+    # ========================================
+    - name: 📋 List published files
+      run: |
+        echo "📂 Contents of publish/wwwroot:"
+        ls -lah publish/wwwroot/
+        echo ""
+        echo "📄 index.html base href:"
+        grep "<base" publish/wwwroot/index.html
+    
+    # ========================================
+    # 9️⃣ Setup GitHub Pages
+    # ========================================
+    - name: ⚙️ Setup Pages
       uses: actions/configure-pages@v4
 
-    - name: Upload artifact
+    # ========================================
+    # 🔟 Upload artifact
+    # ========================================
+    - name: 📤 Upload Pages artifact
       uses: actions/upload-pages-artifact@v3
       with:
-        path: release/wwwroot
-
-  deploy:
-    needs: build
-    runs-on: ubuntu-latest
-    
-    permissions:
-      pages: write
-      id-token: write
+        path: 'publish/wwwroot'
 
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    
-    steps:
-    - name: Deploy to GitHub Pages
+    # ========================================
+    # 1️⃣1️⃣ Deploy to GitHub Pages
+    # ========================================
+    - name: 🚀 Deploy to GitHub Pages
       id: deployment
       uses: actions/deploy-pages@v4