Init website

Author: cbhua

.github/workflows/deploy.yml

@@ -0,0 +1,50 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build Astro site
+        run: npm run build
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./dist
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,6 @@
+node_modules/
+dist/
+.astro/
+.DS_Store
+.env
+.env.*

README.md

@@ -0,0 +1,89 @@
+# Trace Studio Homepage
+
+Static homepage for the [Trace Studio](https://github.com/trace-studio) GitHub organization. Built with [Astro](https://astro.build/), TypeScript, and vanilla CSS.
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Start dev server (http://localhost:4321)
+npm run dev
+
+# Production build
+npm run build
+
+# Preview production build
+npm run preview
+```
+
+## Adding Content
+
+### Add a Game
+
+Create a markdown file at `src/content/games/en/<slug>.md`:
+
+```markdown
+---
+title: "Game Name"
+slug: "game-name"
+status: "released"  # released | in-progress | planned
+summary: "One-line description."
+repoUrl: "https://github.com/trace-studio/game-name"
+demoUrl: "https://game-name.trace-studio.github.io"
+tags: ["strategy", "card-game"]
+components: ["engine", "heuristic", "rl", "llm", "web-demo", "report"]
+locale: "en"
+publishDate: 2025-01-01
+order: 1
+---
+
+Markdown body here.
+```
+
+### Add a Research Post
+
+Create a markdown file at `src/content/research/en/<slug>.md`:
+
+```markdown
+---
+title: "Post Title"
+slug: "post-slug"
+game: "game-name"  # optional — links to a game
+summary: "One-line summary."
+authors: ["Author Name"]
+publishDate: 2025-01-15
+tags: ["heuristic", "game-ai"]
+locale: "en"
+draft: false
+---
+
+Markdown body here.
+```
+
+## Locales
+
+- English: `/` (active)
+- Chinese: `/zh/` (stubbed — translation not yet populated)
+
+All UI strings are in `src/i18n/en.json` and `src/i18n/zh.json`. The `zh.json` file has empty values that fall back to English.
+
+## Project Structure
+
+```
+src/
+├── components/     # Astro components (layout, ui, home, games, research)
+├── content/        # Markdown content collections
+├── i18n/           # Locale string files
+├── lib/            # i18n helpers
+├── pages/          # Route pages
+└── styles/         # Global CSS, tokens, typography, prose
+public/
+├── assets/brand/   # Logo and banner images
+└── favicon.svg
+```
+
+## Deployment
+
+See [docs/deployment.md](docs/deployment.md) for GitHub Pages deployment options.

astro.config.mjs

@@ -0,0 +1,15 @@
+import { defineConfig } from "astro/config";
+import sitemap from "@astrojs/sitemap";
+
+export default defineConfig({
+  site: "https://trace-studio.github.io",
+  base: "/homepage",
+  integrations: [sitemap()],
+  i18n: {
+    defaultLocale: "en",
+    locales: ["en", "zh"],
+    routing: {
+      prefixDefaultLocale: false,
+    },
+  },
+});

docs/deployment.md

@@ -0,0 +1,41 @@
+# Deployment
+
+Two deployment paths for GitHub Pages.
+
+## Option 1: Deploy from this repository
+
+If the site is hosted from the `ts-homepage` repo (e.g., `trace-studio.github.io/ts-homepage`):
+
+```js
+// astro.config.mjs
+export default defineConfig({
+  site: "https://trace-studio.github.io",
+  base: "/ts-homepage",
+  // ...
+});
+```
+
+## Option 2: Deploy as the organization site
+
+If this repo is renamed to `trace-studio.github.io` (the org-level GitHub Pages repo):
+
+```js
+// astro.config.mjs
+export default defineConfig({
+  site: "https://trace-studio.github.io",
+  // no base needed — serves from root
+  // ...
+});
+```
+
+## Build Command
+
+```bash
+npm run build
+```
+
+Output is in `dist/`. Point GitHub Pages to serve from the `dist/` directory (or use a GitHub Action to build and deploy).
+
+## GitHub Actions (future)
+
+A workflow file at `.github/workflows/deploy.yml` can automate builds on push to `main`. This is not included in v1 — add it when ready to deploy.