nuqs

Guide type-safe URL state management in Next.js applications with nuqs.

4|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/allthingslinux/portal --skill nuqs-allthingslinux
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: nuqs
Source: https://github.com/allthingslinux/portal/tree/main/.cursor/skills/nuqs
Command: npx skills add https://github.com/allthingslinux/portal --skill nuqs-allthingslinux

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

nuqs provides best-practice guidance for managing type-safe URL state in Next.js applications, helping teams implement reliable, scalable URL-driven UI without runtime errors.

Core Features & Use Cases

  • Guided rule set: 42 rules across 8 categories covering parser configuration, adapter setup, server integration, and performance.
  • Practical patterns: Concrete examples for useQueryState, useQueryStates, and search params across client/server boundaries.
  • Code-review & generation: Templates and checklists to accelerate code reviews, refactoring, and automated code generation.

Quick Start

Reference the quick-start guide to apply nuqs best practices in your Next.js project and align with the official ruleset.

Frequently Asked Questions about nuqs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage type-safe URL state in Next.js applications?▼

Type-safe URL state in Next.js is managed using nuqs, which provides best-practice guidance for reliable URL-driven UI without runtime errors. It offers 42 rules across 8 categories covering parser configuration, adapter setup, and server integration.

How do I use useQueryState and useQueryStates for search params in Next.js?▼

useQueryState and useQueryStates handle search params in Next.js by applying concrete patterns for type-safe URL state across client and server boundaries. nuqs provides 42 rules and templates to accelerate implementation and refactoring.

Can I synchronize URL search params across client and server components in Next.js?▼

URL search params can be synchronized across client and server components in Next.js using nuqs adapter setup and server integration patterns. This ensures type-safe state management without runtime errors across routing boundaries.

What is the best way to structure parsers for URL state in Next.js?▼

The best way to structure parsers for URL state in Next.js is following nuqs parser configuration rules, which provide type-safe search params handling. The ruleset covers 42 rules across 8 categories including parser configuration and adapter setup.

Does nuqs work with Next.js routing and server components?▼

nuqs works with Next.js routing and server components by providing adapter setup and server integration guidance. It supports type-safe URL state management across client and server boundaries with parser configuration and performance rules.