---
name: "@nuqs"
slug: "nuqs"
description: "Type-safe URL query-string state management for React frameworks, functioning like useState but backed by the URL. The shadcn registry distributes community-contributed custom parsers, adapters, and utilities that extend the core nuqs library. Supports Next.js (app and pages routers), React SPA, Remix, React Router v6/v7, and TanStack Router via adapters. Features built-in parsers (integer, float, boolean, Date), useQueryStates for grouped params, shallow mode, and server-component cache helpers. Free, MIT-licensed. Use for: adding shareable, bookmarkable URL state to any React app without a separate state library."
category: "Hooks/utilities"
tags: ["components", "hooks"]
framework: "react"
license: "MIT"
author: "47ng"
website: "https://nuqs.dev/registry"
github: "https://github.com/47ng/nuqs"
registry: "https://nuqs.dev/r/registry.json"
pro: false
pro_url: null
github_stars: 10661
component_count: 5
generated_at: "2026-07-28T08:00:50.948Z"
---

# @nuqs

Type-safe URL query-string state management for React frameworks, functioning like useState but backed by the URL. The shadcn registry distributes community-contributed custom parsers, adapters, and utilities that extend the core nuqs library. Supports Next.js (app and pages routers), React SPA, Remix, React Router v6/v7, and TanStack Router via adapters. Features built-in parsers (integer, float, boolean, Date), useQueryStates for grouped params, shallow mode, and server-component cache helpers. Free, MIT-licensed. Use for: adding shareable, bookmarkable URL state to any React app without a separate state library.

## Links

- Website: https://nuqs.dev/registry
- GitHub: https://github.com/47ng/nuqs
- Registry JSON: https://nuqs.dev/r/registry.json
- Directory page: https://sh4dcn.vercel.app/registry/nuqs
- This file: https://sh4dcn.vercel.app/md/nuqs.md

## Install

```sh
# add the whole registry (shadcn CLI)
npx shadcn@latest add https://nuqs.dev/r/registry.json
pnpm dlx shadcn@latest add https://nuqs.dev/r/registry.json
bunx shadcn@latest add https://nuqs.dev/r/registry.json
# clone the source repo
git clone https://github.com/47ng/nuqs.git
# fetch the raw registry index
curl -s https://nuqs.dev/r/registry.json
```

## Components (5)

| name | type | description | install |
| --- | --- | --- | --- |
| adapter-inertia | registry:item | Using nuqs in Inertia.js apps (eg: with a Laravel backend) | `npx shadcn@latest add https://nuqs.dev/r/adapter-inertia.json` |
| adapter-onejs | registry:item | Using nuqs in One.js applications. | `npx shadcn@latest add https://nuqs.dev/r/adapter-onejs.json` |
| adapter-react-router-v5 | registry:item | Using nuqs in React Router v5 applications. | `npx shadcn@latest add https://nuqs.dev/r/adapter-react-router-v5.json` |
| adapter-waku | registry:item | Using nuqs in ⛩️ Waku applications. | `npx shadcn@latest add https://nuqs.dev/r/adapter-waku.json` |
| next-typed-links | registry:item | Type-safe linking for Next.js (using typedRoutes + nuqs) | `npx shadcn@latest add https://nuqs.dev/r/next-typed-links.json` |

## For AI agents

```text
You are adding components from @nuqs to a shadcn-compatible project.
1. Read this file (https://sh4dcn.vercel.app/md/nuqs.md) for the component list.
2. Fetch the machine-readable index: https://nuqs.dev/r/registry.json
3. Install a single component with its install command from the table above.
4. Full structured record: https://sh4dcn.vercel.app/json (library slug: nuqs).
```