fix docs

Author: lyoshenka

apps/docs/scripts/generate-sidebar.ts

@@ -1,7 +1,7 @@
 import { writeFileSync } from "node:fs";
 import { resolve, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
-import { DOC_SECTIONS } from "../src/lib/docs-pages.js";
+import { DOC_SECTIONS } from "../src/lib/docs-pages";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 

apps/docs/snap-sidebar.json

@@ -1,38 +1,45 @@
 [
   {
-    "text": "Learn",
+    "text": "Home",
     "items": [
       {
-        "text": "Introduction",
+        "text": "Home",
         "link": "/snap"
       },
       {
-        "text": "Examples",
-        "link": "/snap/examples"
+        "text": "Building Snaps with AI",
+        "link": "/snap/agents"
       }
     ]
   },
   {
-    "text": "Create",
+    "text": "Learn",
     "items": [
       {
         "text": "Building a Snap",
         "link": "/snap/building"
-      }
-    ]
-  },
-  {
-    "text": "Integrate",
-    "items": [
+      },
       {
-        "text": "Adding a Snap to an Existing Website",
-        "link": "/snap/existing-site"
+        "text": "Integrating Snaps",
+        "link": "/snap/integrating"
+      },
+      {
+        "text": "Persistent State",
+        "link": "/snap/persistent-state"
+      },
+      {
+        "text": "Examples",
+        "link": "/snap/examples"
       }
     ]
   },
   {
-    "text": "Reference",
+    "text": "Snap Protocol",
     "items": [
+      {
+        "text": "Overview",
+        "link": "/snap/protocol"
+      },
       {
         "text": "Elements",
         "link": "/snap/elements"
@@ -41,18 +48,10 @@
         "text": "Buttons",
         "link": "/snap/buttons"
       },
-      {
-        "text": "Actions",
-        "link": "/snap/actions"
-      },
       {
         "text": "Effects",
         "link": "/snap/effects"
       },
-      {
-        "text": "Constraints",
-        "link": "/snap/constraints"
-      },
       {
         "text": "Theme & Styling",
         "link": "/snap/theme"
@@ -62,21 +61,16 @@
         "link": "/snap/colors"
       },
       {
-        "text": "Authentication",
-        "link": "/snap/auth"
+        "text": "Actions",
+        "link": "/snap/actions"
       },
       {
-        "text": "Data Store",
-        "link": "/snap/data-store"
-      }
-    ]
-  },
-  {
-    "text": "Agents",
-    "items": [
+        "text": "Constraints",
+        "link": "/snap/constraints"
+      },
       {
-        "text": "Agents",
-        "link": "/snap/agents"
+        "text": "Authentication",
+        "link": "/snap/auth"
       }
     ]
   }

apps/docs/src/app/(docs)/(learn)/page.mdx

@@ -19,6 +19,8 @@ use https://docs.farcaster.xyz/snap/SKILL.md to build me an app that
   manual implementation with the template.
 - [Integrating Snaps](/integrating) — How to serve snap JSON alongside your normal site
   using content negotiation on the `Accept` header.
+- [Persistent State](/persistent-state) — The key-value store available on every snap
+  handler invocation for persisting state between requests.
 - [Examples](/examples) — Sample snap response payloads showing common UI patterns.
 
 ## Reference
@@ -37,8 +39,6 @@ use https://docs.farcaster.xyz/snap/SKILL.md to build me an app that
   bars, and bar charts.
 - [Authentication](/auth) — How POST requests are authenticated with JSON Farcaster
   Signatures (JFS) and how servers verify them.
-- [Data Store](/data-store) — The key-value store available on every snap handler
-  invocation for persisting state between requests.
 
 ## Agents
 

…p/(docs)/(reference)/data-store/page.mdx …(docs)/(learn)/persistent-state/page.mdxapps/docs/src/app/(docs)/(reference)/data-store/page.mdx renamed to apps/docs/src/app/(docs)/(learn)/persistent-state/page.mdx apps/docs/src/app/(docs)/(reference)/data-store/page.mdx renamed to apps/docs/src/app/(docs)/(learn)/persistent-state/page.mdx

@@ -1,7 +1,8 @@
-# Data Store
+# Persistent State
 
-Snaps can persist data between requests using a key-value data store. The store is
-available on every snap handler invocation through `ctx.data`.
+Snaps created with SKILL.md use Neynar hosting and have built-in data storage. They can
+persist data between requests using a key-value data store. The store is available on
+every snap handler invocation through `ctx.data`.
 
 ```ts
 const snap: SnapFunction = async (ctx) => {

apps/docs/src/lib/docs-pages.ts

@@ -17,6 +17,7 @@ const SECTION_APP_FOLDER: Record<string, string> = {
   "Snap Protocol": "(reference)",
 };
 
+// NOTE: keep this in sync with snap-sidebar.json and apps/docs/src/app/(docs)/(learn)/page.mdx
 export const DOC_SECTIONS: DocSection[] = [
   {
     title: "Home",
@@ -31,6 +32,7 @@ export const DOC_SECTIONS: DocSection[] = [
     pages: [
       { pathname: "/building", title: "Building a Snap" },
       { pathname: "/integrating", title: "Integrating Snaps" },
+      { pathname: "/persistent-state", title: "Persistent State" },
       { pathname: "/examples", title: "Examples" },
     ],
   },
@@ -46,7 +48,6 @@ export const DOC_SECTIONS: DocSection[] = [
       { pathname: "/actions", title: "Actions" },
       { pathname: "/constraints", title: "Constraints" },
       { pathname: "/auth", title: "Authentication" },
-      { pathname: "/data-store", title: "Persistent State" },
     ],
   },
 ];