Fix GitHub Pages deployment configuration

Author: AmberLJC

.github/workflows/deploy.yml

@@ -3,32 +3,51 @@ name: Deploy to GitHub Pages
 on:
   push:
     branches: [ main ]
-  pull_request:
-    branches: [ main ]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
 
 jobs:
-  build-and-deploy:
+  build:
     runs-on: ubuntu-latest
-    
     steps:
-    - name: Checkout
-      uses: actions/checkout@v4
-      
-    - name: Setup Node.js
-      uses: actions/setup-node@v4
-      with:
-        node-version: '18'
-        cache: 'npm'
+      - name: Checkout
+        uses: actions/checkout@v4
+        
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+          
+      - name: Install dependencies
+        run: npm ci
+        
+      - name: Build static site
+        run: npm run build
 
-    - name: Install dependencies
-      run: npm ci
-      
-    - name: Build static site
-      run: npm run build
-      
-    - name: Deploy to GitHub Pages
-      uses: peaceiris/actions-gh-pages@v3
-      if: github.ref == 'refs/heads/main'
-      with:
-        github_token: ${{ secrets.GITHUB_TOKEN }}
-        publish_dir: ./out 
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+        
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./out
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4 

setup-github-pages.md

@@ -0,0 +1,47 @@
+# GitHub Pages Setup Guide
+
+## Step 1: Enable GitHub Pages in Repository Settings
+
+1. Go to your repository: `https://github.com/[your-username]/Just-Curieous.github.io`
+2. Click on **Settings** tab
+3. Scroll down to **Pages** in the left sidebar
+4. Under **Source**, select **GitHub Actions**
+5. Click **Save**
+
+## Step 2: Push Your Code
+
+Make sure all your changes are committed and pushed:
+
+```bash
+git add .
+git commit -m "Configure GitHub Pages deployment"
+git push origin main
+```
+
+## Step 3: Check GitHub Actions
+
+1. Go to **Actions** tab in your repository
+2. You should see "Deploy to GitHub Pages" workflow running
+3. Wait for it to complete successfully
+
+## Step 4: Access Your Site
+
+Once deployment is complete, your site will be available at:
+`https://[your-username].github.io/Just-Curieous.github.io/`
+
+## Troubleshooting
+
+### If Actions fail:
+1. Check the Actions tab for error messages
+2. Ensure all files are committed
+3. Verify the workflow file is in `.github/workflows/deploy.yml`
+
+### If site doesn't load:
+1. Wait 5-10 minutes for DNS propagation
+2. Check if the deployment completed successfully
+3. Verify the URL matches your repository name exactly
+
+### Common Issues:
+- Repository name must match exactly: `Just-Curieous.github.io`
+- Main branch must be named `main` (not `master`)
+- All dependencies must be in `package.json`