Scaffold Catalyst docs hub

Add a Docusaurus (TS) site with workspace scripts, local search, CI build + GitHub Pages deploy, and initial multi-audience docs (operators, wallets, builders) cross-linked to canonical repos.

Made-with: Cursor

Author: TheNewAutonomy

.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Install
+        run: npm ci
+
+      - name: Typecheck
+        run: npm run typecheck
+
+      - name: Build (checks internal links)
+        run: npm run build
+

.github/workflows/pages.yml

@@ -0,0 +1,55 @@
+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: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Install
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: site/build
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy
+        id: deployment
+        uses: actions/deploy-pages@v4
+

.gitignore

@@ -0,0 +1,14 @@
+# Dependencies
+node_modules/
+
+# Docusaurus build artifacts
+site/build/
+site/.docusaurus/
+site/.cache/
+
+# Local env / OS noise
+.env
+.env.*
+.DS_Store
+*.log
+

README.md

@@ -1 +1,45 @@
-# catalyst-docs
+# Catalyst Docs
+
+Single, public documentation hub for the Catalyst ecosystem (operators, wallets, builders, protocol + RPC reference).
+
+## Local development
+
+Prereqs:
+- Node.js >= 20
+
+Install:
+
+```bash
+npm install
+```
+
+Run locally:
+
+```bash
+npm run start
+```
+
+Build:
+
+```bash
+npm run build
+```
+
+Serve the production build locally:
+
+```bash
+npm run serve
+```
+
+## Repo layout
+
+- `site/`: Docusaurus app (config, theme, docs content)
+
+## Deploy (GitHub Pages)
+
+This repo is set up to build the site on every PR, and deploy `site/build/` to GitHub Pages on merges to `main`.
+
+Notes:
+- For project pages, Docusaurus uses `baseUrl: "/catalyst-docs/"`.
+- The deployed URL will be the org GitHub Pages host + repo path (example: `https://catalyst-network.github.io/catalyst-docs/`).
+