Publish Dr. MAS project website with GitHub Pages

.github/workflows/pages.yml

@@ -0,0 +1,57 @@
+name: Deploy website to GitHub Pages
+
+on:
+  push:
+    branches: [master]
+    paths:
+      - 'website/**'
+      - '.github/workflows/pages.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: github-pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    if: github.ref == 'refs/heads/master'
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: website
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+      - name: Set up Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: '24'
+          cache: npm
+          cache-dependency-path: website/package-lock.json
+      - name: Configure GitHub Pages
+        uses: actions/configure-pages@v5
+      - name: Install dependencies
+        run: npm ci
+      - name: Build website
+        run: npm run build
+      - name: Upload website artifact
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: website/dist
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

README.md

@@ -7,6 +7,9 @@ Dr. MAS: Stable Reinforcement Learning for Multi-Agent LLM Systems
 </h1>
 
 <p align="center">
+<a href="https://langfengq.github.io/DrMAS/">
+<img src="https://img.shields.io/badge/Project-Page-8C569B" alt="Project Page">
+</a>
 <a href="https://arxiv.org/abs/2602.08847">
 <img src="https://img.shields.io/static/v1?label=arXiv&message=Paper&color=red" alt="arXiv Paper">
 </a>
@@ -30,6 +33,8 @@ Dr. MAS: Stable Reinforcement Learning for Multi-Agent LLM Systems
 </a>
 </p>
 
+The project-page source and visual previews are available in [website/](./website/README.md).
+
 `Dr.MAS` is designed for **end-to-end post-training** of **Multi-Agent LLM Systems** via **Reinforcement Learning (RL)**, enabling multiple LLM-based agents to collaborate on complex reasoning and decision-making tasks.
 
 This framework features **flexible agent registry**, **customizable multi-agent orchestration**, **LLM sharing/non-sharing (e.g., heterogeneous LLMs)**, **per-agent configuration**, and **shared resource pooling**, making it well suited for training multi-agent LLM systems with RL.

website/.gitignore

@@ -0,0 +1,5 @@
+node_modules/
+dist/
+test-results/
+playwright-report/
+.DS_Store

website/README.md

@@ -0,0 +1,30 @@
+# Dr. MAS Project Page
+
+Project page for **Dr. MAS: Stable Reinforcement Learning for Multi-Agent LLM
+Systems**, built with HTML, CSS, JavaScript, Vite, and build-time KaTeX.
+
+## Local Preview
+
+Requires Node.js 22.12+.
+
+```bash
+cd website
+npm ci
+npm run dev
+```
+
+## Build
+
+```bash
+npm run build
+npm run preview
+```
+
+`dist/` is the deployable static site. Relative asset paths support GitHub Pages
+at <https://langfengq.github.io/DrMAS/>. Pushing this review branch does not deploy it.
+
+Edit page content in `index.html` and `src/`. Display equations use `$$...$$`
+inside `data-math` elements and are rendered during the build.
+
+The supplied manuscript is kept once at [public/paper.pdf](public/paper.pdf).
+Figures are from the paper; fonts and their licenses are bundled locally.