Publish Hugo site to GitHub Pages on main

Set baseURL to https://ardurai.github.io/mara/, add deploy job with
upload-pages-artifact and deploy-pages, and document one-time Pages
source setup in website/README.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: gnanirahulnutakki

.github/workflows/hugo.yml

@@ -1,4 +1,4 @@
-# Build Mara static site (Hugo) — upload public/ as Pages artifact
+# Build Mara static site (Hugo) — publish to GitHub Pages on main (optional artifact on all builds).
 name: hugo
 
 on:
@@ -13,6 +13,15 @@ on:
       - '.github/workflows/hugo.yml'
   workflow_dispatch:
 
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: ${{ github.workflow }}-github-pages
+  cancel-in-progress: false
+
 defaults:
   run:
     working-directory: website
@@ -32,8 +41,25 @@ jobs:
       - name: Build
         run: hugo --gc --minify
 
-      - name: Upload site
+      - name: Upload site (artifact)
         uses: actions/upload-artifact@v4
         with:
           name: mara-site
           path: website/public
+
+      - name: Upload Pages artifact
+        if: github.ref == 'refs/heads/main' && github.event_name != 'pull_request'
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: website/public
+
+  deploy:
+    needs: build
+    if: github.ref == 'refs/heads/main' && github.event_name != 'pull_request'
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

README.md

@@ -92,7 +92,7 @@ A **Hugo** static site (home, docs hub, community, quickstart) lives in [`websit
 cd website && hugo server -D
 ```
 
-See [`website/README.md`](website/README.md) for theme notes, production build, and CI. Set `baseURL` in `website/hugo.toml` before deploying.
+See [`website/README.md`](website/README.md) for theme notes, production build, and CI. The Hugo site defaults to **GitHub Pages** (`https://ardurai.github.io/mara/`); adjust `website/hugo.toml` if you use another host.
 
 ## Install and verify
 

website/README.md

@@ -31,8 +31,14 @@ hugo --gc --minify
 
 ## Configuration
 
-- [`hugo.toml`](hugo.toml) — set `baseURL` to your real domain before deploying (placeholder is `https://example.com/`).
+- [`hugo.toml`](hugo.toml) — `baseURL` defaults to the GitHub Pages project URL (`https://ardurai.github.io/mara/`). Update it if you move hosting or attach a custom domain.
 
 ## Deploy
 
-CI can build with [peaceiris/actions-hugo](https://github.com/peaceiris/actions-hugo) (see `.github/workflows/hugo.yml`). Upload `website/public/` as a GitHub Pages artifact or sync to any static host.
+CI builds with [peaceiris/actions-hugo](https://github.com/peaceiris/actions-hugo) and, on pushes to **`main`** (not PRs), publishes to **GitHub Pages** via `.github/workflows/hugo.yml`.
+
+**One-time repo setup:** Settings → Pages → Build and deployment → Source: **GitHub Actions**.
+
+After a successful deploy from `main`, the site is at **https://ardurai.github.io/mara/**.
+
+You can still run `hugo --gc --minify` locally and sync `website/public/` elsewhere if needed.

website/hugo.toml

@@ -1,6 +1,6 @@
 # Mara project site — https://gohugo.io/
-# Replace baseURL when deploying (GitHub Pages, Netlify, etc.).
-baseURL = 'https://example.com/'
+# Default public URL: GitHub Pages (project site). Change when you add a custom domain.
+baseURL = 'https://ardurai.github.io/mara/'
 # Hugo 0.158+ prefers `locale` over deprecated `languageCode`.
 locale = 'en-US'
 title = 'Mara'