47ng/nuqs

Health v2 · maintenance only

Adoption not part of the score

10769 stars · 295 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

nuqs is a type-safe search params state manager for React frameworks, offering a useState-like API that stores state in the URL query string. It supports Next.js (app and pages routers), plain React SPAs, Remix, React Router, and TanStack Router via adapters, with built-in parsers and serializers for common state types.

Use cases

• sync react component state with url query string
• manage filters and pagination in url params in next.js
• type-safe search params in react server components
• shareable urls with encoded app state
• parse and serialize query string values like dates and integers
• manage multiple related querystring keys in react
• use browser back button to navigate state changes

When to choose

• you build React apps (especially Next.js) and want URL-driven, shareable state
• you need end-to-end type safety between server and client components for search params
• you want a tiny (5.9kB) hook-based alternative to manual query string handling
• you need built-in parsers for common types and history control (replace vs append)

When to avoid

• your project is not React-based (Vue, Svelte, Angular)
• you only need to read query params once on page load without reactive updates
• you need complex global state management beyond URL-representable state

Facets

library · maturity stable

state-management serialization routing frontend-framework web-development frontend browser react nextjs url-state query-params search-params type-safety hooks remix react-router tanstack-router nodejs web-server

Member repositories

For agents

markdown · JSON · MCP: product_card(name="47ng/nuqs")