feat(docs-site): polish UI with accessible components and enhanced styling

Add comprehensive UI/UX improvements to the documentation site:

- Custom CSS theme with 700+ lines of polished styling, dark mode support,
  and responsive design tokens
- New EditLink component with "Copy page as Markdown" feature
- generate-page-markdown script for generating copy-ready markdown
- Enhanced Head component with Inter font loading and smooth scroll
- Accessible skip links and keyboard navigation support
- Content improvements across index, getting-started, and architecture
  pages with hero sections and enhanced CardGrid layouts
- Light/dark logo configuration in Starlight config

Author: MasuRii

docs-site/astro.config.ts

@@ -14,7 +14,8 @@ export default defineConfig({
       description:
         'Bridge-first documentation for the ReCursor mobile companion UI and bridge architecture.',
       logo: {
-        src: './src/assets/recursor-logo-light.svg',
+        light: './src/assets/recursor-logo-light.svg',
+        dark: './src/assets/recursor-logo-dark.svg',
         replacesTitle: false,
       },
       social: [
@@ -30,6 +31,7 @@ export default defineConfig({
       customCss: ['./src/styles/custom.css'],
       components: {
         Head: './src/components/Head.astro',
+        EditLink: './src/components/EditLink.astro',
       },
       sidebar: [
         { label: 'Home', link: '/' },

docs-site/package.json

@@ -6,7 +6,7 @@
   "description": "ReCursor documentation site powered by Astro Starlight",
   "packageManager": "npm@11.11.0",
   "scripts": {
-    "generate": "node ./scripts/generate-docs.mjs && node ./scripts/generate-llms.mjs",
+    "generate": "node ./scripts/generate-docs.mjs && node ./scripts/generate-page-markdown.mjs && node ./scripts/generate-llms.mjs",
     "dev": "npm run generate && astro dev",
     "build": "npm run generate && astro build",
     "check": "npm run generate && astro check && astro build",

docs-site/public/page-markdown/architecture.md

@@ -0,0 +1,30 @@
+# Architecture
+
+The architecture section describes the bridge-first system design and the constraints that shape ReCursor's mobile experience.
+
+<div class="hero-note" style="margin-top: 1.5rem; margin-bottom: 2rem;">
+  **Bridge-first by design:** ReCursor intentionally avoids cloud services. All communication between the mobile app and your development environment flows through a local bridge server you control.
+</div>
+
+## Core concepts
+
+- [System overview](/architecture/system-overview/): The core component model: mobile app, bridge server, and Claude Code integration points.
+- [Data flow](/architecture/data-flow/): Message-level sequence diagrams showing how commands travel from mobile to desktop.
+- [Bridge protocol](/architecture/bridge-protocol/): The HTTP/WebSocket protocol specification for bridge communication.
+- [Data models](/architecture/data-models/): Core data structures: requests, responses, sessions, and repositories.
+- [Project structure](/architecture/project-structure/): Repository organization: Flutter app, bridge server, and documentation.
+
+## Design principles
+
+| Principle | Implementation |
+|-----------|---------------|
+| **Local-first** | Bridge runs on localhost, no cloud services required |
+| **Transparent** | All data stays in your network boundary |
+| **Reversible** | No persistent state changes without explicit approval |
+| **Observable** | Full logging and monitoring of all bridge traffic |
+
+## Navigation guide
+
+- Start with [System overview](/architecture/system-overview/) for the core component model
+- Use [Data flow](/architecture/data-flow/) when you need message-level sequence details
+- Read [Bridge protocol](/architecture/bridge-protocol/) and [Project structure](/architecture/project-structure/) for implementation-facing reference material