From c7482c798809834a8f9f46ebd79bc050267e784b Mon Sep 17 00:00:00 2001
From: Isaac Hunja <isaac@kaara.works>
Date: Fri, 6 Mar 2026 07:53:06 +0300
Subject: [PATCH] docs: add How To section to router documentation sidebar

The docs/router/how-to/ directory contains 20 focused how-to guides
covering installation, authentication, testing, UI library integration,
and search parameters, but they were not accessible from the
documentation sidebar navigation.

This adds a 'How To' section to config.json between ESLint and Router
Examples, listing all published guides.

Fixes #6801
---
 docs/router/config.json | 85 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 85 insertions(+)

diff --git a/docs/router/config.json b/docs/router/config.json
index e13b8e403f5..25d5ad827d7 100644
--- a/docs/router/config.json
+++ b/docs/router/config.json
@@ -322,6 +322,91 @@
         }
       ]
     },
+    {
+      "label": "How To",
+      "children": [
+        {
+          "label": "Install TanStack Router",
+          "to": "how-to/install"
+        },
+        {
+          "label": "Use Environment Variables",
+          "to": "how-to/use-environment-variables"
+        },
+        {
+          "label": "Deploy to Production",
+          "to": "how-to/deploy-to-production"
+        },
+        {
+          "label": "Set Up SSR",
+          "to": "how-to/setup-ssr"
+        },
+        {
+          "label": "Migrate from React Router",
+          "to": "how-to/migrate-from-react-router"
+        },
+        {
+          "label": "Set Up Authentication",
+          "to": "how-to/setup-authentication"
+        },
+        {
+          "label": "Integrate Auth Providers",
+          "to": "how-to/setup-auth-providers"
+        },
+        {
+          "label": "Set Up Role-Based Access Control",
+          "to": "how-to/setup-rbac"
+        },
+        {
+          "label": "Set Up Testing",
+          "to": "how-to/setup-testing"
+        },
+        {
+          "label": "Test File-Based Routing",
+          "to": "how-to/test-file-based-routing"
+        },
+        {
+          "label": "Debug Router Issues",
+          "to": "how-to/debug-router-issues"
+        },
+        {
+          "label": "Integrate Shadcn/ui",
+          "to": "how-to/integrate-shadcn-ui"
+        },
+        {
+          "label": "Integrate Material-UI",
+          "to": "how-to/integrate-material-ui"
+        },
+        {
+          "label": "Integrate Framer Motion",
+          "to": "how-to/integrate-framer-motion"
+        },
+        {
+          "label": "Integrate Chakra UI",
+          "to": "how-to/integrate-chakra-ui"
+        },
+        {
+          "label": "Set Up Basic Search Params",
+          "to": "how-to/setup-basic-search-params"
+        },
+        {
+          "label": "Navigate with Search Params",
+          "to": "how-to/navigate-with-search-params"
+        },
+        {
+          "label": "Validate Search Params",
+          "to": "how-to/validate-search-params"
+        },
+        {
+          "label": "Arrays, Objects & Dates in Search Params",
+          "to": "how-to/arrays-objects-dates-search-params"
+        },
+        {
+          "label": "Share Search Params Across Routes",
+          "to": "how-to/share-search-params-across-routes"
+        }
+      ]
+    },
     {
       "label": "Router Examples",
       "children": [],