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.2M
Open issues
45
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.2M weekly downloads. Battle tested
  • First-class TypeScript definitions
  • MIT licensed

Considerations

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

FAQs

Alternatives & similar libraries