useState-like API
Pass a primitive default — the library infers the parser automatically. No imports needed.
String (nullable)
Sync a text input with a URL param. Clearing the input removes the key from the URL entirely.
Pagination
Integer with default 1 — never null. history:'push' creates real history entries so Back/Forward navigates pages.
Boolean Toggles
Two independent boolean params. withDefault ensures the value is always a boolean.
Multi-Select Array
Array values serialized as comma-separated strings. Deselecting all removes the key.
Combined Filters
Manage sort, page and search in one hook. One setFilters() call → one history entry.
Parser Chaining
nuqs-style .withDefault() API on every built-in parser. Includes parseAsIsoDateTime.
Zod Integration
Pass a Zod schema directly. Auto-parses JSON, validates, and falls back to .default() on error.
Debounce + Transition
Built-in debounce with optimistic pending value — UI is instant, URL writes are throttled.