Nuqs screenshot

Nuqs

Author Avatar Theme by 47ng
Updated: 9 Jan 2026
9946 Stars

Type-safe search params state manager for React frameworks - Like useState, but stored in the URL query string.

Overview

Nuqs is an innovative state management tool designed for React frameworks, providing a type-safe way to manage search parameters. Unlike traditional state management solutions, Nuqs allows you to store the state directly in the URL query string, making it an excellent choice for applications that rely on user inputs or search functionalities. This approach not only enhances the user experience but also ensures that the state can be easily shared or bookmarked.

With Nuqs, developers can expect a seamless integration into their existing projects, bringing clarity and simplicity to state management. Its focus on type safety maximizes the potential for error-free coding, making it a great asset for both seasoned developers and newcomers alike.

Features

  • Type-Safe Management: Ensures that your search parameters are strongly typed, reducing runtime errors and improving code reliability.
  • URL Integration: Stores the state in the URL query string, allowing users to share links that represent the exact application state.
  • Simple API: Offers a familiar interface similar to useState, making it easy for React developers to adopt without a steep learning curve.
  • Reactivity: Automatically updates the state in your application whenever the URL changes, keeping the UI in sync with the user’s actions.
  • Built-in Sync: Synchronizes the application state with the browser’s history, enabling users to use the back and forward buttons seamlessly.
  • Lightweight: Adds minimal overhead to your application, ensuring that performance remains top-notch while enhancing functionality.
  • Server-side Compatibility: Works well with server-side rendering, making it suitable for a variety of React applications, including those that need to handle search parameters effectively.