@nuqs

Type-safe URL query-string state management for React frameworks, functioning like useState but backed by the URL. The shadcn registry distributes community-contributed custom parsers, adapters, and utilities that extend the core nuqs library. Supports Next.js (app and pages routers), React SPA, Remix, React Router v6/v7, and TanStack Router via adapters. Features built-in parsers (integer, float, boolean, Date), useQueryStates for grouped params, shallow mode, and server-component cache helpers. Free, MIT-licensed. Use for: adding shareable, bookmarkable URL state to any React app without a separate state library.

5 components react shadcn-cli MIT

website ↗ github ↗ registry ↗

Install this registry

shadcn (npm) npx shadcn@latest add https://nuqs.dev/r/registry.json

pnpm pnpm dlx shadcn@latest add https://nuqs.dev/r/registry.json

bun bunx shadcn@latest add https://nuqs.dev/r/registry.json

fetch registry curl -s https://nuqs.dev/r/registry.json

Components

5 total

Inertia.js Adapter item

Using nuqs in Inertia.js apps (eg: with a Laravel backend)

npx shadcn@latest add https://nuqs.dev/r/adapter-inertia.json

One.js Adapter item

Using nuqs in One.js applications.

npx shadcn@latest add https://nuqs.dev/r/adapter-onejs.json

React Router v5 Adapter item

Using nuqs in React Router v5 applications.

npx shadcn@latest add https://nuqs.dev/r/adapter-react-router-v5.json

Waku Adapter item

Using nuqs in ⛩️ Waku applications.

npx shadcn@latest add https://nuqs.dev/r/adapter-waku.json

Typed Links for Next.js item

Type-safe linking for Next.js (using typedRoutes + nuqs)

npx shadcn@latest add https://nuqs.dev/r/next-typed-links.json