New docs

.github/workflows/docs_build.yml

@@ -0,0 +1,54 @@
+name: Docs build
+
+on:
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Install Node (22.x)
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22.x"
+          cache: pnpm
+          cache-dependency-path: pnpm-lock.yaml
+
+      - name: Enable Corepack
+        run: corepack enable
+
+      - name: Install Dependencies
+        run: pnpm install --frozen-lockfile --network-concurrency 1
+
+      - name: Cache Astro build
+        uses: actions/cache@v4
+        with:
+          path: .astro
+          key: astro-${{ hashFiles('astro.config.mjs', 'pnpm-lock.yaml') }}
+
+      - name: Build reference docs
+        run: pnpm docs:reference
+
+      - name: Build llms.txt bundles
+        run: pnpm docs:llms
+
+      - name: Verify generated docs are up to date
+        run: git diff --exit-code -- docs/
+
+      - name: Generate robots.txt from config
+        run: pnpm docs:robots
+
+      - name: Generate .htaccess from config (Apache hosts only)
+        run: pnpm docs:htaccess
+
+      - name: Build Starlight site
+        run: pnpm docs:site

.github/workflows/docs_deploy.yml.disabled

@@ -0,0 +1,63 @@
+name: Docs deploy
+
+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 pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Install Node (22.x)
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22.x"
+          cache: pnpm
+          cache-dependency-path: pnpm-lock.yaml
+
+      - name: Enable Corepack
+        run: corepack enable
+
+      - name: Install Dependencies
+        run: pnpm install --frozen-lockfile --network-concurrency 1
+
+      - name: Cache Astro build
+        uses: actions/cache@v4
+        with:
+          path: .astro
+          key: astro-${{ hashFiles('astro.config.mjs', 'pnpm-lock.yaml') }}
+
+      - name: Build docs
+        run: pnpm run docs
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: dist/site
+
+  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

.github/workflows/tests.yml

@@ -35,8 +35,14 @@ jobs:
       - name: Install Dependencies
         run: pnpm install --frozen-lockfile --network-concurrency 1
 
-      - name: Install Playwright
-        run: pnpm exec playwright install --with-deps chromium firefox
+      - name: Install Playwright Chromium
+        run: pnpm exec playwright install chromium
+
+      - name: Install Playwright Firefox
+        run: pnpm exec playwright install firefox
+
+      - name: Install Playwright system dependencies
+        run: pnpm exec playwright install-deps chromium firefox
 
       - name: Build
         run: pnpm run build:prod

.gitignore

@@ -5,6 +5,23 @@
 /dist/
 /coverage/
 /jsdoc/
+/.astro/
+
+# Astro build-time mirrors of docs/llms*.txt — generated by
+# scripts/build-llms.ts so the bundles resolve at the deployed site
+# root. Canonical committed copies live at docs/llms.txt and
+# docs/llms-full.txt.
+/public/llms.txt
+/public/llms-full.txt
+
+# Generated by scripts/build-robots.ts from config/site.ts. Run
+# `pnpm docs:robots` (or `pnpm docs`) to (re)build.
+/public/robots.txt
+
+# Generated by scripts/build-htaccess.ts from config/site.ts. Apache-only
+# config; inert on hosts that don't honor .htaccess. Run
+# `pnpm docs:htaccess` (or `pnpm docs`) to (re)build.
+/public/.htaccess
 js-stellar-base/
 
 test/unit/out/