Fix repo setup: pnpm 12, Docusaurus 3.10, PR CI, formatting

.github/workflows/ci.yml

@@ -0,0 +1,68 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+jobs:
+  build:
+    timeout-minutes: 15
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v7
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v6
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v7
+        with:
+          node-version-file: .nvmrc
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Check formatting
+        run: pnpm format:check
+
+      - name: Typecheck
+        run: pnpm typecheck
+
+      - name: Build
+        run: pnpm build
+
+      - name: Upload Pages artifact
+        if: github.event_name != 'pull_request' && github.ref == 'refs/heads/main'
+        uses: actions/upload-pages-artifact@v5
+        with:
+          path: ./build
+
+  deploy:
+    needs: build
+    if: github.event_name != 'pull_request' && github.ref == 'refs/heads/main'
+    timeout-minutes: 10
+    runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    concurrency:
+      group: pages
+      cancel-in-progress: false
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v5

.nvmrc

@@ -0,0 +1 @@
+24

.prettierignore

@@ -0,0 +1,6 @@
+node_modules
+build
+.docusaurus
+pnpm-lock.yaml
+src/openapi.json
+docs/rpc

.prettierrc.json

@@ -0,0 +1 @@
+{}

README.md

@@ -1,25 +1,41 @@
-# Website
+# xch.dev
 
-This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
+Source for [xch.dev](https://xch.dev), the documentation for Sage and the Chia Wallet SDK. It's built with [Docusaurus](https://docusaurus.io/).
 
-### Installation
+## Requirements
 
-```
-pnpm install
-```
+- Node.js 24 (see `.nvmrc`; 20 or newer works)
+- pnpm, at the version pinned in `package.json`'s `packageManager` field. Running `corepack enable` picks it up automatically.
 
-### Local Development
+## Development
 
-```
+```sh
+pnpm install
 pnpm start
 ```
 
-This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+`pnpm start` and `pnpm build` both generate the RPC reference pages first. The generated pages go to `docs/rpc`, which is gitignored. To regenerate them on their own, run `pnpm gen-api-docs`.
 
-### Build
+Before opening a PR, run:
 
-```
+```sh
+pnpm format:check   # or `pnpm format` to fix
+pnpm typecheck
 pnpm build
 ```
 
-This command generates static content into the `build` directory and can be served using any static contents hosting service.
+CI runs the same checks on every pull request.
+
+## RPC reference
+
+The RPC pages are generated from `src/openapi.json`, which comes from Sage. To update it to a Sage release (this needs git and a Rust toolchain):
+
+```sh
+pnpm sync-openapi v0.13.1   # omit the tag to use the latest release
+```
+
+To use a local Sage checkout instead, set `SAGE_DIR=/path/to/sage`.
+
+## Deployment
+
+Every push to `main` builds the site and deploys it to GitHub Pages through `.github/workflows/ci.yml`.