
nuqs
Type-safe state manager for React that keeps state in the URL query string.
nuqs keeps React state in the URL query string. Its hooks read a query key and return the value with a setter, in the same shape as React’s useState, and parsers convert the string to types such as integers, booleans, dates and arrays. An adapter wraps the app for the router in use, and the package offers adapters for Next.js, a React single-page app, Remix, React Router and TanStack Router. Server code can parse the same keys with a loader, and server components can read them from a cache built from the parsers.
Worth knowing
Parsers do not validate their input, so values that must have a particular shape need a schema library on top. Browsers rate-limit updates to the URL, so changes are queued and throttled, while the state the hook returns updates at once.
Identity
- Status
- Active
- Maintainer
- François Best4
- Maintained by
- Individual4
- First release
- 20203
Rendering and deploy
- Install with
- npm5
Releases
Adoption
Sources
- 2026-11-16: links, Written in, GitHub stars
api.github.com/repos/47ng/nuqs - 2026-11-16: links
nuqs.dev/docs/installation - 2026-11-16: First release, Current major version
api.github.com/repos/47ng/nuqs/releases - 2026-11-16: Maintainer, Maintained by, License, License model
github.com/47ng/nuqs/blob/next/LICENSE - 2026-11-16: Categories, Install with
github.com/47ng/nuqs/blob/next/README.md - 2026-11-16: Last release
api.github.com/repos/47ng/nuqs/releases/latest - 2026-11-16: Contributors
api.github.com/repos/47ng/nuqs/contributors?per_page=1 - 2026-11-16: npm downloads a week
api.npmjs.org/downloads/range/2026-11-01:2026-11-07/nuqs