# nuqs

Type-safe state manager for React that keeps state in the URL query string.


Source: https://findsoftware.frbit.cloud/nuqs/
Last reviewed: 2026-11-16
Listed since: 2026-11-16

## Record

### Links

- home: https://nuqs.dev
- repository: https://github.com/47ng/nuqs
- docs: https://nuqs.dev/docs/installation
- x: https://x.com/nuqs47ng
- bluesky: https://bsky.app/profile/nuqs.dev

### Identity

- status: active
- maintainer: François Best
- maintainerType: individual
- parent: unknown
- firstRelease: 2020
- hqCountry: unknown

### Kind

- category: library
- hosting: unknown
- language: javascript
- runtime: unknown
- runtimeMin: unknown
- basedOn: unknown

### Content

- contentStore: not applicable
- databases: not applicable
- adminUi: not applicable
- headlessApi: not applicable
- templating: not applicable
- i18n: not applicable

### Rendering and deploy

- runsAs: not applicable
- renderingModes: not applicable
- installMethod: npm

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: 2
- latestReleaseDate: 2026-11-10

### Adoption

- githubStargazers: 10908
- packagistDownloads: not applicable
- npmWeeklyDownloads: 7771550
- contributors: 77
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: unknown
- dependentPackages: unknown

### Sources

- urls: https://api.github.com/repos/47ng/nuqs (read 2026-11-16)
- urls: https://api.github.com/repos/47ng/nuqs (read 2026-11-16)
- urls: https://nuqs.dev/docs/installation (read 2026-11-16)
- firstRelease: https://api.github.com/repos/47ng/nuqs/releases (read 2026-11-16)
- maintainer: https://github.com/47ng/nuqs/blob/next/LICENSE (read 2026-11-16)
- maintainerType: https://github.com/47ng/nuqs/blob/next/LICENSE (read 2026-11-16)
- language: https://api.github.com/repos/47ng/nuqs (read 2026-11-16)
- category: https://github.com/47ng/nuqs/blob/next/README.md (read 2026-11-16)
- installMethod: https://github.com/47ng/nuqs/blob/next/README.md (read 2026-11-16)
- license: https://github.com/47ng/nuqs/blob/next/LICENSE (read 2026-11-16)
- licenseModel: https://github.com/47ng/nuqs/blob/next/LICENSE (read 2026-11-16)
- currentMajor: https://api.github.com/repos/47ng/nuqs/releases (read 2026-11-16)
- latestReleaseDate: https://api.github.com/repos/47ng/nuqs/releases/latest (read 2026-11-16)
- githubStargazers: https://api.github.com/repos/47ng/nuqs (read 2026-11-16)
- contributors: https://api.github.com/repos/47ng/nuqs/contributors?per_page=1 (read 2026-11-16)
- npmWeeklyDownloads: https://api.npmjs.org/downloads/range/2026-11-01:2026-11-07/nuqs (read 2026-11-16)

## Notes

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.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0
