From fe88fa68d151cdef3827ee92ad5373d21ea88cb8 Mon Sep 17 00:00:00 2001
From: sleitor <sleitor@users.noreply.github.com>
Date: Tue, 3 Mar 2026 02:31:11 +0000
Subject: [PATCH] docs(router): add How To section to docs navigation sidebar

The how-to/ directory contains 20+ step-by-step guides covering
authentication, search params, testing, SSR, UI integrations, and more,
but none of them were linked from the docs navigation config.

Add a new 'How To' section to docs/router/config.json between
'Guides' and 'API' with entries for all existing how-to guides.

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

diff --git a/docs/router/config.json b/docs/router/config.json
index e13b8e403f5..d0705cabb88 100644
--- a/docs/router/config.json
+++ b/docs/router/config.json
@@ -267,6 +267,101 @@
         }
       ]
     },
+    {
+      "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 RBAC",
+          "to": "how-to/setup-rbac"
+        },
+        {
+          "label": "Navigate with Search Params",
+          "to": "how-to/navigate-with-search-params"
+        },
+        {
+          "label": "Set Up Basic Search Params",
+          "to": "how-to/setup-basic-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": "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 Chakra UI",
+          "to": "how-to/integrate-chakra-ui"
+        },
+        {
+          "label": "Integrate Framer Motion",
+          "to": "how-to/integrate-framer-motion"
+        }
+      ],
+      "frameworks": [
+        {
+          "label": "react",
+          "children": []
+        },
+        {
+          "label": "solid",
+          "children": []
+        }
+      ]
+    },
     {
       "label": "API",
       "children": [