feat(nav): product shelves and Keep building tab

CONTEXT.md

@@ -15,3 +15,29 @@ _Avoid_: Session middleware, web adapter
 **SDK**:
 The language client plus any first-party framework helper that ships in that client.
 _Avoid_: Adapter (for web-framework helpers)
+
+### Keep building
+
+**First success**:
+The reader has finished the product hello-world: one AgentKit tool call, or one SaaSKit sign-in.
+_Avoid_: Go-live, production, first-run
+
+**Keep building**:
+The stage after first success. It holds how-tos and recipes only. The tab opens a hub, not a how-to or a recipe.
+_Avoid_: Guides, leftover, Developer Resources, second product journey
+
+**Keep building hub**:
+A short page that names the next how-to, then lists recipes as a pick-list. It is a recommended next plus a shelf, not a 50/50 fork.
+_Avoid_: Journey, index, leftover
+
+**How-to**:
+A short page for one Scalekit dashboard or workspace task after first success. How-tos are read in order. The order follows the dashboard after first success, not a docs brainstorm. Account deletion is not a how-to.
+_Avoid_: Recipe, product-journey page, leftover
+
+**Recipe**:
+A page for one job in the reader's own app or agent. The reader can land on it, finish the job, and leave. Recipes have no required order.
+_Avoid_: Cookbook, how-to, feature tour, quickstart
+
+**Product journey**:
+The main AgentKit or SaaSKit left rail from hello-world through implementation.
+_Avoid_: Keep building, how-to sequence

astro.config.mjs

@@ -13,7 +13,6 @@ import starlightThemeNova from 'starlight-theme-nova'
 import starlightVideos from 'starlight-videos'
 import starlightLinksValidator from 'starlight-links-validator'
 import starlightLlmsTxt from 'starlight-llms-txt'
-import starlightBlog from 'starlight-blog'
 import { sidebar as sidebarConfig, topics, exclude } from './src/configs/sidebar.config'
 import { redirects } from './src/configs/redirects.config'
 import { llmsConfig } from './src/configs/llms.config.ts'
@@ -26,6 +25,7 @@ import Icons from 'unplugin-icons/vite'
 import netlify from '@astrojs/netlify'
 import openapiToMarkdown from './src/integrations/openapi-markdown'
 import { injectAgentHeader } from './src/integrations/inject-agent-header.ts'
+import assignHowToTopic from './src/integrations/assign-how-to-topic'
 
 // https://astro.build/config
 export default defineConfig({
@@ -104,6 +104,8 @@ export default defineConfig({
         starlightImageZoom({
           showCaptions: true,
         }),
+        // Shared /how-to/** pages have no product folder; assign a topic so Starlight can pick a Cookbooks rail.
+        assignHowToTopic(),
         starlightSidebarTopics(sidebarConfig, { topics, exclude }),
         starlightDocSearch({
           appId: '7554BDRAJD',
@@ -149,14 +151,6 @@ export default defineConfig({
           },
           // No baseUrl — prevents llms.txt generation (already handled by starlight-llms-txt)
         }),
-        starlightBlog({
-          prefix: 'cookbooks',
-          rss: false,
-          metrics: {
-            readingTime: true,
-            words: 'total',
-          },
-        }),
       ],
       head: [
         {
@@ -447,8 +441,7 @@ export default defineConfig({
       },
     },
     optimizeDeps: {
-      // starlight-blog uses Astro/Starlight virtual modules that should not be pre-bundled.
-      exclude: ['starlight-blog'],
+      include: ['vue'],
     },
     // Provide a safe fallback for libraries that reference the CommonJS
     // global `__dirname` (e.g. canvaskit-wasm used by astro-og-canvas).

package.json

@@ -46,7 +46,6 @@
     "canvaskit-wasm": "0.40.0",
     "jose": "^6.2.2",
     "sharp": "^0.35.3",
-    "starlight-blog": "^0.26.1",
     "starlight-image-zoom": "^0.14.2",
     "starlight-links-validator": "^0.24.1",
     "starlight-llms-txt": "^0.10.0",