prototype(docs): product guide sidebars for cookbooks and how-tos

astro.config.mjs

@@ -16,7 +16,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'
@@ -29,6 +28,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({
@@ -107,6 +107,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',
@@ -140,14 +142,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: [
         {
@@ -453,8 +447,6 @@ export default defineConfig({
     },
     optimizeDeps: {
       include: ['vue'],
-      // starlight-blog uses Astro/Starlight virtual modules that should not be pre-bundled.
-      exclude: ['starlight-blog'],
     },
     // Provide a safe fallback for libraries that reference the CommonJS
     // global `__dirname` (e.g. canvaskit-wasm used by astro-og-canvas).

netlify/edge-functions/serve-markdown.ts

@@ -165,6 +165,10 @@ export const config: Config = {
     '/images/*',
     '/fonts/*',
     '/favicon*',
+    // Auth routes serve JSON, never HTML→markdown, and the local edge proxy
+    // mishandles their empty-body POSTs. `/api/*` needs no entry — the handler
+    // only rewrites `text/html` responses, so spec files pass straight through.
+    '/auth/*',
     '/*.js',
     '/*.css',
     '/*.json',

netlify/edge-functions/track-agents.ts

@@ -38,6 +38,11 @@ export const config = {
     '/fonts/*',
     '/favicon*',
     '/og/*',
+    // Auth routes only: the local Netlify edge proxy mishandles empty-body POSTs
+    // (e.g. /auth/refresh) and surfaces TypeError: fetch failed as unhandled rejections.
+    // `/api/*` stays tracked — agents fetch the OpenAPI specs under it, which is
+    // exactly the traffic this function exists to measure.
+    '/auth/*',
     '/*.js',
     '/*.css',
     '/*.png',

package.json

@@ -53,7 +53,6 @@
     "react": "^19.2.5",
     "react-dom": "^19.2.5",
     "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",