LLM reference: Fetch llms.txt for the documentation index and latest API. Full docs in one file: llms-full.txt. Human-readable docs: nuqs.dev/docs.

Do not duplicate upstream API reference in this skill — use llms.txt / llms-full.txt for parsers, options, server cache, testing adapter, and troubleshooting.

When NOT to use nuqs (read first)

On TanStack Router or TanStack Start, prefer the router’s built-in search params unless you have a concrete reason to add nuqs.

Situation	Use instead
App-owned filters, tabs, pagination, sort on a route	Route `validateSearch` (Zod) + `Route.useSearch()`, `loaderDeps`, typed `<Link search={…}>`
Loaders / `beforeLoad` need query state	Same parsers in `validateSearch`; `search` is typed in loader args
FMC TanStack Router / Start stack	Skill `tanstack-router-conventions` → `references/params-search-ui-routes.md`
API routes under `routes/api/*`	Parse `request.url` in `GET` with Zod — not route `validateSearch` (`tanstack-start-conventions`)

Use nuqs on TanStack only when: