docs: add the shared page components and the Reference Project

.gitattributes

@@ -47,3 +47,9 @@ registry/**/*.html linguist-vendored
 .claude/skills/**/*.mp3 filter=lfs diff=lfs merge=lfs -text
 .agents/skills/**/*.mp4 filter=lfs diff=lfs merge=lfs -text
 .agents/skills/**/*.mp3 filter=lfs diff=lfs merge=lfs -text
+
+# The documentation Reference Project ships real voice and music. Only the WAV
+# masters exceed the repository's 500 KB non-LFS limit, so only those are routed
+# through LFS — the small MP3 stings stay plain so the example still clones and
+# renders without `git lfs pull`.
+examples/docs-reference-project/**/*.wav filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -97,6 +97,8 @@ examples/*
 !examples/k8s-jobs/**
 !examples/gcp-cloud-run
 !examples/gcp-cloud-run/**
+!examples/docs-reference-project
+!examples/docs-reference-project/**
 # …but never the local smoke run's build/render artifacts.
 examples/gcp-cloud-run/scripts/gcp-smoke-artifacts/
 packages/studio/data/

.oxlintrc.json

@@ -3,7 +3,7 @@
   "categories": {
     "correctness": "error"
   },
-  "plugins": ["react", "typescript"],
+  "plugins": ["react", "react-hooks", "typescript"],
   "ignorePatterns": [
     ".scratch/",
     "dist/",
@@ -24,7 +24,19 @@
       ],
       "excludeFiles": ["**/*.test.ts", "**/*.test.tsx", "packages/cli/src/telemetry/feedback.ts"],
       "rules": {
-        "no-console": ["error", { "allow": ["error", "warn"] }]
+        "no-console": [
+          "error",
+          {
+            "allow": ["error", "warn"]
+          }
+        ]
+      }
+    },
+    {
+      "files": ["docs/snippets/**/*.jsx", "docs/snippets/**/*.tsx"],
+      "rules": {
+        "react-hooks/rules-of-hooks": "error",
+        "react-hooks/exhaustive-deps": "warn"
       }
     }
   ]