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.