{"meta":{"name":"FindSoftware","page":"https://findsoftware.frbit.cloud/nuqs/","markdown":"https://findsoftware.frbit.cloud/nuqs.md","license":"https://creativecommons.org/licenses/by/4.0/","attribution":"FindSoftware, CC BY 4.0","note":"Attributes are recorded, never scored. An absent field means unknown, never zero and never bad."},"record":{"id":"nuqs","name":"nuqs","urls":{"home":"https://nuqs.dev","repository":"https://github.com/47ng/nuqs","docs":"https://nuqs.dev/docs/installation"},"category":["library"],"description":"Type-safe state manager for React that keeps state in the URL query string.","maintainer":"François Best","maintainerType":"individual","firstRelease":2020,"language":"javascript","contentStore":null,"databases":null,"adminUi":null,"headlessApi":null,"templating":null,"i18n":null,"runsAs":null,"renderingModes":null,"installMethod":"npm","licenseModel":"open-source","license":"MIT","currentMajor":"2","latestReleaseDate":"2026-11-10T00:00:00.000Z","githubStargazers":10908,"contributors":77,"packagistDownloads":null,"npmWeeklyDownloads":7771550,"social":{"x":"https://x.com/nuqs47ng","bluesky":"https://bsky.app/profile/nuqs.dev"},"checkedAt":"2026-11-16T00:00:00.000Z","addedAt":"2026-11-16T00:00:00.000Z","sources":[{"field":"urls","url":"https://api.github.com/repos/47ng/nuqs","checkedAt":"2026-11-16T00:00:00.000Z"},{"field":"urls","url":"https://api.github.com/repos/47ng/nuqs","checkedAt":"2026-11-16T00:00:00.000Z"},{"field":"urls","url":"https://nuqs.dev/docs/installation","checkedAt":"2026-11-16T00:00:00.000Z"},{"field":"firstRelease","url":"https://api.github.com/repos/47ng/nuqs/releases","checkedAt":"2026-11-16T00:00:00.000Z"},{"field":"maintainer","url":"https://github.com/47ng/nuqs/blob/next/LICENSE","checkedAt":"2026-11-16T00:00:00.000Z"},{"field":"maintainerType","url":"https://github.com/47ng/nuqs/blob/next/LICENSE","checkedAt":"2026-11-16T00:00:00.000Z"},{"field":"language","url":"https://api.github.com/repos/47ng/nuqs","checkedAt":"2026-11-16T00:00:00.000Z"},{"field":"category","url":"https://github.com/47ng/nuqs/blob/next/README.md","checkedAt":"2026-11-16T00:00:00.000Z"},{"field":"installMethod","url":"https://github.com/47ng/nuqs/blob/next/README.md","checkedAt":"2026-11-16T00:00:00.000Z"},{"field":"license","url":"https://github.com/47ng/nuqs/blob/next/LICENSE","checkedAt":"2026-11-16T00:00:00.000Z"},{"field":"licenseModel","url":"https://github.com/47ng/nuqs/blob/next/LICENSE","checkedAt":"2026-11-16T00:00:00.000Z"},{"field":"currentMajor","url":"https://api.github.com/repos/47ng/nuqs/releases","checkedAt":"2026-11-16T00:00:00.000Z"},{"field":"latestReleaseDate","url":"https://api.github.com/repos/47ng/nuqs/releases/latest","checkedAt":"2026-11-16T00:00:00.000Z"},{"field":"githubStargazers","url":"https://api.github.com/repos/47ng/nuqs","checkedAt":"2026-11-16T00:00:00.000Z"},{"field":"contributors","url":"https://api.github.com/repos/47ng/nuqs/contributors?per_page=1","checkedAt":"2026-11-16T00:00:00.000Z"},{"field":"npmWeeklyDownloads","url":"https://api.npmjs.org/downloads/range/2026-11-01:2026-11-07/nuqs","checkedAt":"2026-11-16T00:00:00.000Z"}],"status":"active","ai":"authored"},"prose":"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.\n\n## Worth knowing\n\nParsers 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."}