docs: more! (#4775)

Add comprehensive authentication, testing, and debugging how-to guides
to enhance documentation.

---

[Open in
Web](https://cursor.com/agents?id=bc-ea21e97d-685a-451f-9700-6955d86ef170)
• [Open in
Cursor](https://cursor.com/background-agent?bcId=bc-ea21e97d-685a-451f-9700-6955d86ef170)

Learn more about [Background
Agents](https://docs.cursor.com/background-agent/web-and-mobile)

---------

Co-authored-by: Cursor Agent <[email protected]>

Author: tannerlinsley

docs/router/framework/react/guide/authenticated-routes.md

@@ -166,3 +166,19 @@ export const Route = createFileRoute('/dashboard')({
 You can _optionally_, also use the [Non-Redirected Authentication](#non-redirected-authentication) approach to show a login form instead of calling a **redirect**.
 
 This approach can also be used in conjunction with Pathless or Layout Route to protect all routes under their parent route.
+
+## Related How-To Guides
+
+For detailed, step-by-step implementation guides, see:
+
+- [How to Set Up Basic Authentication](../how-to/setup-authentication.md) - Complete setup with React Context and protected routes
+- [How to Integrate Authentication Providers](../how-to/setup-auth-providers.md) - Use Auth0, Clerk, or Supabase
+- [How to Set Up Role-Based Access Control](../how-to/setup-rbac.md) - Implement permissions and role-based routing
+
+## Examples
+
+Working authentication examples are available in the repository:
+
+- [Basic Authentication Example](https://github.com/TanStack/router/tree/main/examples/react/authenticated-routes) - Simple authentication with context
+- [Firebase Authentication](https://github.com/TanStack/router/tree/main/examples/react/authenticated-routes-firebase) - Firebase Auth integration
+- [TanStack Start Auth Examples](https://github.com/TanStack/router/tree/main/examples/react) - Various auth implementations with TanStack Start

docs/router/framework/react/how-to/README.md

@@ -14,6 +14,17 @@ This directory contains focused, step-by-step instructions for common TanStack R
 - [Set Up Server-Side Rendering (SSR)](./setup-ssr.md) - Implement SSR with TanStack Router
 - [Migrate from React Router v7](./migrate-from-react-router.md) - Complete migration guide from React Router v7
 
+### Authentication
+
+- [Set Up Basic Authentication](./setup-authentication.md) - Implement basic auth with React Context
+- [Integrate Authentication Providers](./setup-auth-providers.md) - Use Auth0, Clerk, or Supabase
+- [Set Up Role-Based Access Control](./setup-rbac.md) - Add permission-based routing
+
+### Testing & Debugging
+
+- [Set Up Testing](./setup-testing.md) - Comprehensive testing setup with Vitest, React Testing Library, and Playwright
+- [Debug Router Issues](./debug-router-issues.md) - Troubleshoot common routing problems and performance issues
+
 ### UI Library Integration
 
 - [Integrate with Shadcn/ui](./integrate-shadcn-ui.md) - Set up Shadcn/ui components with animations and styling