feat(docs): scaffold Astro Starlight site in docs/

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: Paul Mulligan

docs/.gitignore

@@ -0,0 +1,21 @@
+# build output
+dist/
+# generated types
+.astro/
+
+# dependencies
+node_modules/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store

docs/astro.config.mjs

@@ -0,0 +1,61 @@
+// @ts-check
+import { defineConfig } from "astro/config";
+import starlight from "@astrojs/starlight";
+
+// https://astro.build/config
+export default defineConfig({
+  site: "https://claudius-docs.pages.dev",
+  integrations: [
+    starlight({
+      title: "Claudius",
+      description:
+        "Embeddable AI chat widget powered by Claude. React component + standalone script embed, backed by Cloudflare Workers.",
+      social: [
+        {
+          icon: "github",
+          label: "GitHub",
+          href: "https://github.com/PMDevSolutions/Claudius",
+        },
+      ],
+      editLink: {
+        baseUrl: "https://github.com/PMDevSolutions/Claudius/edit/main/docs/",
+      },
+      sidebar: [
+        {
+          label: "Getting Started",
+          items: [
+            { slug: "getting-started/introduction" },
+            { slug: "getting-started/quick-start" },
+            { slug: "getting-started/local-development" },
+          ],
+        },
+        {
+          label: "Configuration",
+          items: [{ autogenerate: { directory: "configuration" } }],
+        },
+        {
+          label: "Deployment",
+          items: [{ autogenerate: { directory: "deployment" } }],
+        },
+        {
+          label: "Plugins & Tools",
+          items: [{ autogenerate: { directory: "plugins" } }],
+        },
+        { label: "RAG", items: [{ autogenerate: { directory: "rag" } }] },
+        {
+          label: "Channels",
+          items: [{ autogenerate: { directory: "channels" } }],
+        },
+        {
+          label: "API Reference",
+          items: [{ autogenerate: { directory: "api" } }],
+        },
+        {
+          label: "Migration Guides",
+          items: [{ autogenerate: { directory: "migration" } }],
+        },
+        { label: "FAQ", slug: "faq" },
+      ],
+    }),
+  ],
+});

docs/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "claudius-docs",
+  "version": "1.3.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "astro dev",
+    "start": "astro dev",
+    "build": "astro build",
+    "preview": "astro preview",
+    "astro": "astro"
+  },
+  "dependencies": {
+    "@astrojs/starlight": "^0.40.0",
+    "astro": "^6.4.5",
+    "sharp": "^0.34.5"
+  }
+}