FindSoftware

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

Current major version
23
Last release
2026-11-106

Adoption

GitHub stars
10,9081
npm downloads a week
7,771,5508
Contributors
777

Why these figures do not compare

Sources

  1. 2026-11-16: links, Written in, GitHub stars
    api.github.com/repos/47ng/nuqs
  2. 2026-11-16: links
    nuqs.dev/docs/installation
  3. 2026-11-16: First release, Current major version
    api.github.com/repos/47ng/nuqs/releases
  4. 2026-11-16: Maintainer, Maintained by, License, License model
    github.com/47ng/nuqs/blob/next/LICENSE
  5. 2026-11-16: Categories, Install with
    github.com/47ng/nuqs/blob/next/README.md
  6. 2026-11-16: Last release
    api.github.com/repos/47ng/nuqs/releases/latest
  7. 2026-11-16: Contributors
    api.github.com/repos/47ng/nuqs/contributors?per_page=1
  8. 2026-11-16: npm downloads a week
    api.npmjs.org/downloads/range/2026-11-01:2026-11-07/nuqs

Last reviewed · Listed since Edit on GitHubThis page as markdownas JSON