docs: Continue search param how-tos (#4814)

Add 'Validate Search Parameters with Schemas' how-to guide and update
related documentation.

---

[Open in
Web](https://cursor.com/agents?id=bc-d5e46bba-1af4-4db9-8631-541879529bf0)
• [Open in
Cursor](https://cursor.com/background-agent?bcId=bc-d5e46bba-1af4-4db9-8631-541879529bf0)
• [Open Docs](https://docs.cursor.com/background-agent/web-and-mobile)

---------

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

Author: tannerlinsley

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

@@ -43,7 +43,7 @@ This directory contains focused, step-by-step instructions for common TanStack R
 
 **Intermediate Level (Common Patterns):**
 
-- [ ] Validate Search Parameters with Schemas - Use schema validation libraries for robust validation and type safety
+- [x] [Validate Search Parameters with Schemas](./validate-search-params.md) - Use schema validation libraries for robust validation and type safety
 - [ ] Handle Complex Search Parameter Types - Work with arrays, objects, dates, and nested data
 - [ ] Share Search Parameters Across Routes - Inherit and manage search params across route hierarchies
 

docs/router/framework/react/how-to/drafts/validate-search-params.draft.md

@@ -327,6 +327,17 @@ function ConditionalNavigation() {
 </Link>
 ```
 
+## Common Next Steps
+
+After mastering navigation with search parameters, you might want to:
+
+- [Validate Search Parameters with Schemas](./validate-search-params.md) - Add robust validation with Zod, Valibot, or ArkType
+
+<!-- Uncomment when guides are available
+- [Handle Complex Search Parameter Types](./complex-search-param-types.md) - Work with arrays, objects, dates, and nested data
+- [Share Search Parameters Across Routes](./share-search-params-across-routes.md) - Inherit and manage search params across route hierarchies
+-->
+
 ## Related Resources
 
 - [TanStack Router Search Params Guide](https://tanstack.com/router/latest/docs/framework/react/guide/search-params) - Official documentation

docs/router/framework/react/how-to/navigate-with-search-params.md

@@ -50,11 +50,9 @@ function ProductsPage() {
 - **Error Handling**: Built-in validation error management
 - **Maintainability**: Clear, declarative schema definitions
 
-## Validation Library Options
+## Validation Library Setup
 
-TanStack Router supports any standard schema-compliant validation library. Choose the one that best fits your project:
-
-### Zod (Most Popular)
+TanStack Router supports any standard schema-compliant validation library. This guide focuses on Zod for examples, but you can use any validation library:
 
 ```bash
 npm install zod @tanstack/zod-adapter
@@ -75,61 +73,9 @@ export const Route = createFileRoute('/products')({
 })
 ```
 
-### Valibot (Lightweight Alternative)
-
-```bash
-npm install valibot @tanstack/valibot-adapter
-```
+**For detailed validation library comparisons and advanced validation patterns, see:** [Validate Search Parameters with Schemas](./validate-search-params.md)
 
-```tsx
-import { valibotValidator, fallback } from '@tanstack/valibot-adapter'
-import * as v from 'valibot'
 
-const searchSchema = v.object({
-  page: fallback(v.number(), 1),
-  category: fallback(v.string(), 'all'),
-})
-
-export const Route = createFileRoute('/products')({
-  validateSearch: valibotValidator(searchSchema),
-  component: ProductsPage,
-})
-```
-
-### Yup
-
-```bash
-npm install yup
-```
-
-```tsx
-import * as yup from 'yup'
-
-const searchSchema = yup.object({
-  page: yup.number().default(1),
-  category: yup.string().default('all'),
-})
-
-export const Route = createFileRoute('/products')({
-  validateSearch: (search) => searchSchema.validateSync(search),
-  component: ProductsPage,
-})
-```
-
-### Custom Validation Function
-
-For complete control, implement your own validation:
-
-```tsx
-export const Route = createFileRoute('/products')({
-  validateSearch: (search: Record<string, unknown>) => ({
-    page: Number(search.page) || 1,
-    category: (search.category as string) || 'all',
-    showSale: Boolean(search.showSale),
-  }),
-  component: ProductsPage,
-})
-```
 
 ## Step-by-Step Setup with Zod
 
@@ -470,8 +416,12 @@ const schema = z.object({
 
 ## Common Next Steps
 
-<!-- Uncomment when guides are available
+After setting up basic search parameters, you might want to:
+
+- [Validate Search Parameters with Schemas](./validate-search-params.md) - Add robust validation with Zod, Valibot, or ArkType
 - [Navigate with Search Parameters](./navigate-with-search-params.md) - Learn to update search params with Links and navigation
+
+<!-- Uncomment when guides are available
 - [Handle Complex Search Parameter Types](./complex-search-param-types.md) - Work with arrays, objects, dates, and nested data
 -->