enhance routing documentation with new topics and examples

Author: LadyBluenotes

packages/router-skills/manifest.json

@@ -5,18 +5,25 @@
     "v1": {
       "index": "skills/v1/index.md",
       "files": [
+        "skills/v1/authenticated-routes.md",
+        "skills/v1/custom-search-serialization.md",
+        "skills/v1/data-loading-advanced.md",
         "skills/v1/data-refresh.md",
+        "skills/v1/document-head-management.md",
         "skills/v1/error-boundaries.md",
         "skills/v1/file-based-routing.md",
+        "skills/v1/history-types.md",
         "skills/v1/index.md",
         "skills/v1/layouts.md",
         "skills/v1/links.md",
         "skills/v1/loaders.md",
         "skills/v1/matching-and-location.md",
+        "skills/v1/navigation-blocking.md",
         "skills/v1/navigation.md",
         "skills/v1/not-found-boundaries.md",
         "skills/v1/params.md",
         "skills/v1/redirects.md",
+        "skills/v1/render-optimizations.md",
         "skills/v1/route-context.md",
         "skills/v1/route-ids.md",
         "skills/v1/route-lazy-loading.md",
@@ -26,8 +33,12 @@
         "skills/v1/router-devtools.md",
         "skills/v1/router-setup.md",
         "skills/v1/router-state.md",
+        "skills/v1/routing-strategies.md",
+        "skills/v1/scroll-restoration.md",
         "skills/v1/search-params.md",
-        "skills/v1/ssr-loaders.md"
+        "skills/v1/ssr-loaders.md",
+        "skills/v1/static-route-data.md",
+        "skills/v1/type-safety.md"
       ]
     }
   }

packages/router-skills/skills/topics.json

@@ -1,15 +1,18 @@
 [
   "index.md",
   "router-setup.md",
+  "routing-strategies.md",
   "route-trees.md",
   "layouts.md",
   "route-ids.md",
   "route-meta.md",
   "params.md",
   "search-params.md",
+  "custom-search-serialization.md",
   "loaders.md",
   "route-context.md",
   "data-refresh.md",
+  "data-loading-advanced.md",
   "error-boundaries.md",
   "not-found-boundaries.md",
   "links.md",
@@ -18,8 +21,16 @@
   "matching-and-location.md",
   "redirects.md",
   "route-masking.md",
+  "authenticated-routes.md",
   "file-based-routing.md",
   "ssr-loaders.md",
   "route-lazy-loading.md",
-  "router-devtools.md"
+  "router-devtools.md",
+  "document-head-management.md",
+  "scroll-restoration.md",
+  "navigation-blocking.md",
+  "history-types.md",
+  "static-route-data.md",
+  "render-optimizations.md",
+  "type-safety.md"
 ]

packages/router-skills/skills/v1/index.md

@@ -29,6 +29,7 @@ Core setup and structure:
 - Creating a shared UI shell across child routes -> `@skills/router/layouts`
 - Stabilizing references when paths change -> `@skills/router/route-ids`
 - Attaching route metadata for UI or analytics -> `@skills/router/route-meta`
+- Picking a routing strategy -> `@skills/router/routing-strategies`
 
 Routing params and search:
 
@@ -40,6 +41,7 @@ Data loading and refresh:
 - Fetching route-critical data before render -> `@skills/router/loaders`
 - Passing dependencies like API clients to loaders -> `@skills/router/route-context`
 - Prefetching and invalidating after mutations -> `@skills/router/data-refresh`
+- Handling deferred/external data or mutations -> `@skills/router/data-loading-advanced`
 
 Navigation and links:
 
@@ -57,6 +59,7 @@ Errors, redirects, and masking:
 - Handling missing data or unmatched routes -> `@skills/router/not-found-boundaries`
 - Redirecting from loaders/actions -> `@skills/router/redirects`
 - Presenting friendly URLs for internal routes -> `@skills/router/route-masking`
+- Protecting routes behind auth -> `@skills/router/authenticated-routes`
 
 File-based routing:
 
@@ -67,6 +70,14 @@ Rendering and runtime:
 - Ensuring loader data is serializable for SSR -> `@skills/router/ssr-loaders`
 - Lazy-loading route modules for code-splitting -> `@skills/router/route-lazy-loading`
 - Inspecting routes and matches during development -> `@skills/router/router-devtools`
+- Managing head tags and titles -> `@skills/router/document-head-management`
+- Restoring scroll positions between navigations -> `@skills/router/scroll-restoration`
+- Blocking navigation on unsaved changes -> `@skills/router/navigation-blocking`
+- Choosing history implementations -> `@skills/router/history-types`
+- Customizing search param serialization -> `@skills/router/custom-search-serialization`
+- Attaching static route data -> `@skills/router/static-route-data`
+- Improving render performance -> `@skills/router/render-optimizations`
+- Tightening type safety and utilities -> `@skills/router/type-safety`
 
 Next: