nuqs

SKILL.md

Type-safe URL query state management for React. Like useState, but stored in the URL.

| parseAsString | string | ?q=hello | | parseAsInteger | number | ?page=1 | | parseAsFloat | number | ?price=9.99 | | parseAsHex | number | ?color=ff0000 | | parseAsBoolean | boolean | ?active=true | | parseAsIsoDateTime | Date | ?date=2024-01-15T10:30:00Z | | parseAsTimestamp | Date | ?t=1705312200000 | | parseAsArrayOf(parser) | T[] | ?tags=a,b,c |

| parseAsArrayOf(parser, ';') | T[] | ?ids=1;2;3 (custom separator) | | parseAsJson () | T | ?data={"key":"value"} | | parseAsStringEnum(values) | enum | ?status=active | | parseAsStringLiteral(arr) | literal | ?sort=asc | | parseAsNumberLiteral(arr) | literal | ?dice=6 |

Use when implementing URL query state in React, managing search params, syncing state with URL, building filterable/sortable lists, pagination with URL state, or using nuqs/useQueryState/useQueryStates hooks in Next.js, Remix, React Router, or plain React. Source: noklip-io/agent-skills.

View raw