nuqs | Type-safe search params state management for React
About
nuqs is a powerful tool designed for React developers, offering type-safe search params state management that seamlessly integrates with the URL query string, much like useState. This innovative solution is particularly helpful for developers working with React, Next.js, Remix, and other frameworks, providing a robust and efficient way to manage state changes. By leveraging nuqs, developers can enhance their application's performance and user experience.
Details
- Type-safe: End-to-end type safety between Server and Client components.
- Universal: Supports a wide range of frameworks including Next.js (app & pages routers), React SPA, Remix, React Router, and more.
- Simple: Offers a familiar React.useState-like API that syncs with the URL.
- Batteries included: Built-in parsers & serializers for common state types.
- History controls: Ability to replace or append to navigation history and use the Back button to navigate state updates.
- Related queries: Use
useQueryStateshook to manage multiple keys at once. - Client-first: Shallow updates by default, with the option to notify the server to re-render RSCs (with throttle control).
- Server cache:









