React Library HubReact Library Hub
NU

Nuqs

nuqs

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

Routing
url state
url
querystring
query string
search params
next-usequerystate
useQueryState
useQueryStates
nextjs
react
Documentation GitHub npm
Stars
11k
Weekly
3.3M
Open issues
53
Bundle
~25 kB

Installation

npm install nuqs

Code example

import { BrowserRouter, Routes, Route, Link } from "nuqs";

export function Example() {
  return (
    <BrowserRouter>
      <nav>
        <Link to="/">Home</Link>
      </nav>
      <Routes>
        <Route path="/" element={<h1>Home</h1>} />
      </Routes>
    </BrowserRouter>
  );
}

Pros & cons

Pros

  • Actively maintained by François Best
  • 3.3M weekly downloads. Battle tested
  • First-class TypeScript definitions
  • MIT licensed

Considerations

  • Adds roughly ~25 kB to your bundle
  • Not supported in React Native
  • 53 open issues on GitHub

FAQs

Alternatives & similar libraries