Enrich LLM-facing documentation with context and navigation

docs/astro.config.ts

@@ -11,6 +11,7 @@ import sitemap from "@astrojs/sitemap";
 import { llmsTxtPostProcess } from "./src/integrations/llms-txt-post-process";
 
 import config from "./src/config/config.json";
+import { sidebarGroups } from "./src/config/sidebar-groups";
 
 // https://astro.build/config
 export default defineConfig({
@@ -120,72 +121,24 @@ export default defineConfig({
         Footer: "./src/components/starlight/Footer.astro",
         SiteTitle: "./src/components/starlight/SiteTitle.astro",
       },
-      sidebar: [
-        {
-          label: "Getting Started",
-          collapsed: true,
-          autogenerate: { directory: "docs/getting-started" },
-        },
-        {
-          label: "Screenshots & Recordings",
-          collapsed: true,
-          items: [
-            { slug: "docs/features/capturing/screenshots" },
-            { slug: "docs/features/capturing/recordings" },
-            { slug: "docs/features/capturing/floating-thumbnail" },
-            { slug: "docs/features/capturing/app-store-connect-optimization" },
-            { slug: "docs/features/capturing/touch-indicators" },
-            { slug: "docs/features/capturing/120-fps-recordings" },
-          ],
-        },
-        {
-          label: "Simulator Camera",
-          link: "/docs/features/capturing/simulator-camera-support",
-        },
-        {
-          label: "Status Bar",
-          link: "/docs/features/capturing/statusbar-appearance",
-        },
-        {
-          label: "Design Comparison",
-          collapsed: true,
-          autogenerate: { directory: "docs/features/design-comparison" },
-        },
-        {
-          label: "App Actions",
-          collapsed: true,
-          autogenerate: { directory: "docs/features/app-actions" },
-        },
-        {
-          label: "Networking",
-          collapsed: true,
-          autogenerate: { directory: "docs/features/networking" },
-        },
-        {
-          label: "Build Insights",
-          collapsed: true,
-          autogenerate: { directory: "docs/features/build-insights" },
-        },
-        {
-          label: "Accessibility",
-          collapsed: true,
-          autogenerate: { directory: "docs/features/accessibility" },
-        },
-        {
-          label: "User Defaults Editor",
-          link: "/docs/features/user-defaults-editor",
-        },
-        {
-          label: "Settings",
-          collapsed: true,
-          autogenerate: { directory: "docs/settings" },
-        },
-        {
-          label: "Support",
-          collapsed: true,
-          autogenerate: { directory: "docs/support" },
-        },
-      ],
+      sidebar: sidebarGroups.map((group) => {
+        if (group.directory) {
+          return {
+            label: group.label,
+            collapsed: group.collapsed,
+            autogenerate: { directory: group.directory },
+          };
+        }
+        const slugs = group.slugs!;
+        if (slugs.length === 1) {
+          return { label: group.label, link: `/${slugs[0]}` };
+        }
+        return {
+          label: group.label,
+          collapsed: group.collapsed,
+          items: slugs.map((slug) => ({ slug })),
+        };
+      }),
     }),
     mdx(),
     llmsTxtPostProcess(),

docs/public/llms-ctx.txt

@@ -0,0 +1,43 @@
+# RocketSim — Product Context
+
+## What is RocketSim?
+RocketSim is a macOS developer tool that enhances Apple's iOS Simulator with professional-grade features for capturing, debugging, testing, and design validation. It's available on the Mac App Store and used by individual developers and large teams worldwide.
+
+## Who is it for?
+iOS, macOS, watchOS, and visionOS developers who use Xcode and the iOS Simulator for app development and testing.
+
+## Core Feature Areas
+
+### Capturing
+Professional screenshots and recordings with device bezels, custom backgrounds, touch indicators, and App Store Connect optimization. Supports GIF, MP4, and JPEG/PNG formats.
+
+### Networking
+Real-time network traffic monitoring via RocketSim Connect, historical networking insights, and network speed throttling (3G, Edge, airplane mode) for testing poor connectivity.
+
+### App Actions
+Test push notifications, deep links/universal links, location simulation, and privacy permissions without a physical device. Manage everything from a persistent side window.
+
+### Design Comparison
+Overlay design mockups from Figma or Sketch with adjustable opacity. Add grid overlays and rulers. Use the pixel-level magnifier for precise layout verification.
+
+### Accessibility
+Toggle accessibility settings (Dynamic Type, Increase Contrast, Bold Text, Reduce Motion, etc.) from the side window. VoiceOver Navigator visualizes element order and supports keyboard-driven navigation.
+
+### Build Insights
+Track Xcode build counts, durations, and trends. Compare incremental vs. clean builds. Team Build Insights lets teams compare performance across machines and Xcode versions.
+
+### Other
+User Defaults real-time editor, status bar customization, simulator camera support, and configurable keyboard shortcuts.
+
+## Technical Details
+- Platform: macOS (enhances the iOS/watchOS/visionOS Simulator in Xcode)
+- Distribution: Mac App Store (out-of-store distribution available on request — contact support@rocketsim.app)
+- Sandboxed: Yes
+- RocketSim Connect: Local Bonjour-based framework for Simulator-to-RocketSim communication (debug builds only)
+
+## Links
+- Website: https://www.rocketsim.app
+- Documentation: https://www.rocketsim.app/docs
+- GitHub (issues & features): https://github.com/AvdLee/RocketSimApp
+- YouTube: https://www.youtube.com/@rocketsimapp
+- Developer: Antoine van der Lee (https://www.avanderlee.com)

docs/src/config/sidebar-groups.ts

@@ -0,0 +1,75 @@
+interface SidebarGroupDef {
+  label: string;
+  collapsed?: boolean;
+  /** For autogenerate groups: directory relative to the content collection root */
+  directory?: string;
+  /** For explicit item/link groups: slug paths relative to the content collection root */
+  slugs?: string[];
+}
+
+export const sidebarGroups: SidebarGroupDef[] = [
+  {
+    label: "Getting Started",
+    collapsed: true,
+    directory: "docs/getting-started",
+  },
+  {
+    label: "Screenshots & Recordings",
+    collapsed: true,
+    slugs: [
+      "docs/features/capturing/screenshots",
+      "docs/features/capturing/recordings",
+      "docs/features/capturing/floating-thumbnail",
+      "docs/features/capturing/app-store-connect-optimization",
+      "docs/features/capturing/touch-indicators",
+      "docs/features/capturing/120-fps-recordings",
+    ],
+  },
+  {
+    label: "Simulator Camera",
+    slugs: ["docs/features/capturing/simulator-camera-support"],
+  },
+  {
+    label: "Status Bar",
+    slugs: ["docs/features/capturing/statusbar-appearance"],
+  },
+  {
+    label: "Design Comparison",
+    collapsed: true,
+    directory: "docs/features/design-comparison",
+  },
+  {
+    label: "App Actions",
+    collapsed: true,
+    directory: "docs/features/app-actions",
+  },
+  {
+    label: "Networking",
+    collapsed: true,
+    directory: "docs/features/networking",
+  },
+  {
+    label: "Build Insights",
+    collapsed: true,
+    directory: "docs/features/build-insights",
+  },
+  {
+    label: "Accessibility",
+    collapsed: true,
+    directory: "docs/features/accessibility",
+  },
+  {
+    label: "User Defaults Editor",
+    slugs: ["docs/features/user-defaults-editor"],
+  },
+  {
+    label: "Settings",
+    collapsed: true,
+    directory: "docs/settings",
+  },
+  {
+    label: "Support",
+    collapsed: true,
+    directory: "docs/support",
+  },
+];