@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

The @standardschema.dev interface for @nuqs.47ng.com is ready for review 👀 github.com/47ng/nuqs/pu... 🟣 I'll play with that on stream tomorrow with the experimental @tanstack.com Router adapter, to pass the nuqs search params definitions validation & type inference to TSR's validateSearch. 🤞

📦 In the next version of @nuqs.47ng.com: Loaders get a strict mode option, that throws errors on *invalid* search param values, rather than falling back to the default value. Will land in the next beta today along with Standard Schema support. 👀

I played a little with @expo.dev SDK 53 which can now load ESM, and therefore can load @nuqs.47ng.com 🙌 Still some skill issues on my part on how Expo and React Native works compared to the web, but it looks promising.

📦 [email protected] is out! 🚀 The first beta in the 2.5 release line just dropped, with Debounce support: perfect for search inputs, sliders, and server-side updates where you only care about a final value. Also lots of internal changes, like fixing tearing issues. Try it out: pnpm add nuqs@beta

“The URL is the first piece of UI your users will see. Design it as such.” — love this. I’ve often had a bit of the ick about state in params, but this article gives me some great ideas on doing it gracefully

✍️ New post on the @nuqs.47ng.com blog: Type-safety for URL state is only the tip of the iceberg. Beware of the dangers below. 🧊🚢 - URL limits - Time safety - Immutability nuqs.47ng.com/blog/beware-...

nuqs has joined the @vercel.com open source program! 🙌 More than the platform credits, the greatest value here will be access to the community, making sure we ship quality updates that benefit all.

This is a great demo of @nuqs.47ng.com by @betterstack.com, TL;DRing the docs in 10 minutes 🙌

New issue of Frontend Snacks just dropped 🔥 We covered, → The most overlooked feature in Next.js 15 → JSX Over the Wire by @danabra.mov → @vite.dev, @nuqs.47ng.com Featured @kevinpowell.co podcast with @joshwcomeau.com, t3 chat by @t3.gg durable streams + more Read by 9k+ devs: bit.ly/44kbB51

The most important part of the @nuqs.47ng.com codebase is the test suite. I would not be able to sleep after making changes if I didn't have this safety net. 19 end-to-end test environments might seem overkill, but the amount of behaviour breakages it catches is priceless.

📦 [email protected] is out! 🚀 It fixes a bug with the @nextjs.org pages router where multiple queries (?foo=1&foo=2) were being read in the wrong order after updating another key. Try it out: pnpm add nuqs@latest github.com/47ng/nuqs/re...