nuqs

Overview

nuqs is a type-safe search params state manager for React frameworks: like useState, but stored in the URL query string. The nuqs shadcn registry extends the core library with community adapters, parsers and utilities that install through the shadcn CLI or can be copied as code snippets, and it publishes an RSS feed for new additions.

The core library supports the Next.js app and pages routers, plain React SPAs, Remix, React Router and TanStack Router out of the box. The registry adds adapters for frameworks the core package does not cover, so the same URL state hooks work across more stacks. nuqs is MIT licensed, and the registry page currently tracks nuqs 2.10.2.

Features

• Inertia.js adapter: Use nuqs in Inertia.js apps, typically paired with Laravel, Phoenix, Django or Rails backends.
• One.js adapter: Support for One, the React and React Native web-plus-native framework.
• Waku adapter: Support for the minimal Waku React framework (0.22.0 and later).
• React Router v5 adapter: URL state for apps still on React Router v5.
• UUID parser: Validates UUID strings, versions 1 to 8, in the query string.
• Typed links for Next.js: A utility for type-safe links on Next.js 15.5 and later.
• Core library: Built-in parsers for integers, floats, booleans and dates, history modes, shallow updates and server-side cache access.

Tech stack

• React, TypeScript, nuqs, shadcn registry

Registry

Install via the shadcn CLI registry:

npx shadcn@latest add @nuqs/component-name