📦 [email protected] is out! 🚀 - bug fix when passing null to clear a key configured with parseAsArrayOf(...).withDefault([]) - parseAsBoolean is now case-insensitive → /?bool=TRUE does what you expect Try it out: pnpm add nuqs@latest

📦 nuqs has passed 1M weekly downloads on @npmjs.bsky.social 🚀 Thanks everyone! 🫶

My talk at @nextjs.org conf is online! Go watch it, it contains two gems: - The dangers and limits of URL state (to make you a better engineer) - A live demo of how @nuqs.dev uses a declarative approach to type-safe and time-safe behaviours, in a composable way.

Post-conf weekend project: adding support for the @shadcn.com CLI in @nuqs.dev to install: - parsers - adapters - little snippets that make more sense to vendor into your codebase & tweak as needed First one is the utility I showed in my talk for type-safe linking (with typedRoutes) in @nextjs.org

📦 [email protected] is out! 🚀 It includes a bug fix for debounce with `shallow: false` which sent unnecessary stale URL updates to the server. Try it out: pnpm add nuqs@latest

nuqs has passed 9k stars 🌟 Thank you everyone! 🫶

I have been looking up to the @pmnd.rs collective for a while, the quality of the software they produce is inspiring. Honoured to see them using @nuqs.dev 🫶

📦 [email protected] is out! 🚀 Two rapid-fire PRs by @tkdodo.eu 🔥 - Fixed a bug with MultiParsers & history: push - Prevent a re-render when doing setState(x => x) (same reference) in useQueryStates Try it out: pnpm add nuqs@latest

📦 [email protected] is out! 🚀 - MultiParsers: `parseAsNativeArrayOf`, and turn key repetition into Record, Map, Set, anything, with custom parsers. Thanks @tkdodo.eu ! 🙌 - Fixed a bug with flickering optimistic state on update Try it out: pnpm add nuqs@latest

📦 [email protected] is out! 🚀 ✨ MultiParsers allow transforming repeated keys in the URL into more complex data types. This had been a long-requested one, thanks @tkdodo.eu! 🫶 🧪 The testing adapter gets an optional memory to behave more closely to real frameworks. Try it out: pnpm add nuqs@beta

Relive the brilliance of #ReactParis 2025! 🌟 Catch up on last conf's unforgettable sessions: ➡️ Type Safe URL State Management in #React with nuqs -by- @francoisbest.com 🎞️ www.youtube.com/watch?v=U__R... 😉 See you next March 2026 👉🏽 react.paris

@nuqs.dev v3 will likely require @react.dev 19. We managed to work around not using `useOptimistic` with hacks, but to properly support optimistic local state updates while the URL update is queued, with concurrent rendering & Suspense, we need to do it the right way.

I need to get better at SEO. A lot of folks can't remember the name `nuqs`, but know what it's about, and can't find it with search terms. Neither the docs, the GitHub repo, nor the NPM package page rank for some critical keywords.

I sat down with @kapehe.bsky.social to chat about @nuqs.dev, open-source, community, and desserts 🍰 Open Source Stories S1E3 www.youtube.com/watch?v=9PJx...

Proud to have contributed this feature to @nuqs.dev ❤️

Why do nuqs URL updates occur client-side only by default? Because you're guaranteed to run @react.dev on the client, but not all frameworks do SSR. With `shallow: false`, you opt-out of this client-only behaviour, and cross the network boundary for search params you need during SSR.

Imagine a local-first, distributed, peer-to-peer, immutable data exchange system. This is not BitTorrent. It’s what you get from putting your app state in the URL.

🗣️ Big news: I'll be speaking at @nextjs.org Conf '25, on Oct 22 in SF ! We'll cover a few tricks @nuqs.dev has up its sleeve to scale URL state in Next.js (some I yet need to finish building 😅). So thankful for the opportunity 🙌

New section in the @nuqs.dev landing page. A huge thank you to all these wonderful people 🫶

🔗 Introducing our new domain name: nuqs.dev 2 years ago, I restarted work on the useQueryState hook to support the @nextjs.org app router. Since then, the project exploded: ⭐ +8k stars 📦 +30M downloads 👥 +50 contributors 🩷 +23 sponsors Thank you, everyone! 🫶

📦 [email protected] is out! 🚀 - ✨ `processUrlSearchParams` middleware: sort the querystring alphabetically (for SEO & cache) or process it before updating the URL. - 💎 Zod codecs community parser - ⚠️ Log a warning when using debounce with shallow: true with a link to docs Try it out: pnpm add nuqs@latest

Absolutely love Nuqs. I don’t leave home without it!

Can URL state compose? Find out out what @francoisbest.com thinks on our latest episode www.youtube.com/watch?v=2x5B... creators.spotify.com/pod/profile/...

How far can you get with URL state management? Find our with out latest guest @francoisbest.com creator of NUQS www.youtube.com/watch?v=2x5B... creators.spotify.com/pod/profile/...

In the next version of @nuqs.47ng.com: the adapters get a middleware 🔌 - Process URLSearchParams as you wish - Examples: sort alphabetically, add versioning, etc I'm still not a big fan of the whole URL shifting around on updates, but a lot of folks have asked for stable ordering (for caching).

A long time ago I wrote a rudimentary post on storing state in URLs: johnnyreilly.com/react-usesea... - at the time I thought there was much more that could be done... And it looks like @nuqs.47ng.com has done it!

Is there a tool that, given a set of .d.ts files, gives you the minimum version of TypeScript supported? TIL @nuqs.47ng.com requires TS ^5, and that requirement came in silently as a feature was merged (const modifiers on generics). I need to automate this to prevent further type breaking changes.

📦 [email protected] is out! 🚀 It fixes a referential stability issue with the testing adapter. The state updater function is now stable across renders & state updates in test environments (@vitest.dev, Jest etc) Try it out: pnpm add nuqs@latest

This Week In React 247 🍿 Read and subscribe! thisweekinreact.com/newsletter/247 ⚛️ React - nuqs - Concurrent React - Apollo - shadcn CLI - Fragment Refs - Streamdown - Waku - React-Aria 📱 RN - Expo Launch - Maestro - SPM - Screens - BottomSheet - Jest

🎥 New video: how to use Zod codecs with nuqs 👀 - ⚡️ Type-safe input (string-based) and output schemas - ☑️ Validation on write - 🪶 Super lightweight

Since this one is missing the social video, here it is! Looking forward to meeting y'all: 🗓️ Nov 28th, IRL in London 🇬🇧 🗓️ Dec 1st, online 🌐

📦 [email protected] is out! 🚀 🐞 It fixes a bug with @cloudflare.social Workers ("Disallowed operation called within global scope"), by lazily creating the throttle queue's AbortController. TL;DR: you can ship on CFW again now. 🚀 Try it out: pnpm add nuqs@latest

Prototyping some UI for a docs card showing: - When a feature was introduced - If applicable, when it was deprecated (turns the callout into a warning) - What frameworks are supported Inspired from @developer.mozilla.org 🫶 cc @fuma-nama.bsky.social (I'm not a designer lol)

Zod 4.1 was released, and with it a new feature: .codec 🙌 It allows **bidirectional** conversion to/from two data types, for (de)serialisation. A lot of folks asked me "why not zod in @nuqs.47ng.com?", the answer is going to be much different now. Can't wait for this to land in Standard Schema 🚀

To address community feedback and questions, we've updated the Debounce docs to add clarifications. TL;DR: - Use debounce with `shallow: false` when doing server-side data fetching (RSCs, gSSP, loaders) - For client-side fetching (React Query, SWR, tRPC), debounce the returned state instead.

📦 [email protected] is (finally) out! 🚀 Lots of new features, bug fixes and improvements: ⏱️ Debounce ☑️ Standard Schema ⚡ Key isolation 🏖️ TanStack Router support Interactive blog post to go through it all ⬇️ nuqs.47ng.com/blog/nuqs-2.5 Try it out: pnpm add nuqs@latest

📦 [email protected] is out! 🚀 Likely the last beta before shipping 2.5 🤘 - Adds more options to be specified as global defaults on the adapter - Bundle reduction & deps: nuqs has now zero dependencies! Follow @tkdodo.eu's advice and try it out: > pnpm add nuqs@beta

📦 [email protected] is out! 🚀 ✨ New feature: Key isolation / fine grained subscriptions: only re-render relevant components when _their_ part of the URL changes. → For @react.dev SPA, @remix.run, @reactrouter.com v{6,7} & TSR 🐞 Fixed a bug with @tanstack.com Router & parseAsJson Try it out!

I managed to reduce the @nuqs.47ng.com bundle size quite a bit by replacing the useQueryState implementation to use useQueryStates internally 🙌 But 2.5.0 is still quite a bit bigger than 2.4 due to all the additions 😬

I’ve been using Fumadocs for the @nuqs.47ng.com docs since day 1, it’s pretty amazing. RSCs are a great use-case for docs & static content in general, with interspersed islands of client-side interactivity. Also, the stock theme is 🔥

📦 [email protected] is out! 🚀 It adds a couple of features: - Change global defaults for options at the adapter level (thanks @tkdodo.eu! 🔥) - Export package.json for @vite.dev module federation Try it out: pnpm add nuqs@beta

📦 [email protected] is out! 🚀 It adds a couple of bug fixes: - Type-safety of default values when using the object signature of useQueryState (thanks @tkdodo.eu 🙌) - Better compat with older CJS codebases via require(esm) Try it out: pnpm add nuqs@beta

This is a nuqs appreciation post. Made by the, literally, best @francoisbest.com ❤️

nuqs is way more awesome and powerful than it has any right to be

📦 [email protected] is out! 🚀 It adds experimental support for @tanstack.com Router 🏝️🙌 - Use community-based nuqs components in TSR - Connect nuqs parser definitions to TSR's validateSearch for type-safe linking* Try it out: pnpm add nuqs@beta

🌟 8k stars on @github.com, thank you everyone! 🙌

The best library for URL state in React is nuqs It provides clean and simple hooks that look just like useState but sync automatically with the URL Here's how to use it

Great news: I’ll be speaking at @reactadvanced.gitnation.org London in November! 🙌 I’ll be talking about @nuqs.47ng.com and how URL state gives your applications superpowers. 🦸 Register via my badge to watch the live stream for free, or see you there in person! 👋

Yeah it feels much better to be able to declare validators inline with the builder pattern. Weekend project: testing this out in practice, and figuring out a story for enabling experimental validation on write without breaking changes.

📦 [email protected] is out! 🚀 It adds a couple of features: - Standard Schema generation: validate & infer types with other tools (tRPC, TanStack Router), using your existing search params definitions - Strict mode for loaders & cache (see quoted post) Try it out: pnpm add nuqs@beta