Improve docs

website/.npmrc

@@ -0,0 +1,3 @@
+# Required until docusaurus-markdown-source-plugin declares React 19 in peerDependencies.
+# Project uses React 19; the plugin only lists react@^18.0.0.
+legacy-peer-deps=true

website/docusaurus.config.js

@@ -4,9 +4,13 @@
 // There are various equivalent ways to declare your Docusaurus config.
 // See: https://docusaurus.io/docs/api/docusaurus-config
 
+import path from 'path';
+import {fileURLToPath} from 'url';
 import dotenv from 'dotenv';
 import {themes as prismThemes} from 'prism-react-renderer';
 
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
 dotenv.config();
 
 // This runs in Node.js - Don't use client-side code here (browser APIs, JSX...)
@@ -289,6 +293,8 @@ const config = {
       }),
     }),
   plugins: [
+    path.join(__dirname, 'plugins', 'markdown-source-docs.js'),
+
     process.env.POSTHOG_API_KEY && [
       "posthog-docusaurus",
       {

website/package.json

@@ -20,6 +20,7 @@
     "@giscus/react": "^3.1.0",
     "@mdx-js/react": "^3.0.0",
     "clsx": "^2.0.0",
+    "docusaurus-markdown-source-plugin": "^2.0.1",
     "dotenv": "^17.2.3",
     "gsap": "^3.13.0",
     "posthog-docusaurus": "^2.0.5",