nuqs

PSA: given the state of the supply chain security theatre on GitHub & NPM, and the scale of recent attacks, we're no longer accepting 3rd party PRs on nuqs for the time being. In time, I hope, this too shall pass. 🙏 github.com/47ng/nuqs/di...

📦 nuqs@2.10.2 is out! 🚀 It fixes a bug of state flickering when a sync render interrupted a startTransition in React Router, and a bug in Next.js 16.4.0 with shallow updates interfering with each other. Changelog: nuqs.dev/changelog Try it out: pnpm add nuqs@latest

📦 nuqs@2.10.0 is out! 🚀 The React SPA adapter is now SSR-compatible for @astro.build, Inertia.js, @fastify.dev etc. Feed it the `serverSearch` prop to avoid a flash of defaults on island hydration. Changelog: nuqs.dev/changelog#v2... Try it out: pnpm add nuqs@latest

📦 nuqs@2.9.6 is out! 🚀 It fixes an issue with pending URL updates not resetting on Back navigation in Next.js pages router & TanStack Router, when no useQueryState(s) hooks were mounted. Also minor correctness fixes for parsers. nuqs.dev/docs/changel...

📦 nuqs@2.9.5 is out! 🚀 It adds SSR support to the community Inertia adapter, and fixes 6 minor edge-case bugs. Full changelog: nuqs.dev/changelog#v2... Try it out: pnpm add nuqs@latest

📦 nuqs@2.9.3 is out! 🚀 It fixes a bug where state updates would blink/replay when pending state updates done in startTransition were rebased on top of other priority updates. Concurrent React is fun. Try it out: pnpm add nuqs@latest

📦 nuqs@2.9.2 is out! 🚀 It fixes a React concurrency issue where a discarded render could leave query state stuck out of sync with the URL. Try it out: pnpm add nuqs@latest

The replay of my @forkit.community talk is out: youtu.be/slbSwQo8Xqc?...

📦 nuqs@2.9.1 is out! 🚀 It includes many bug fixes, a few found by @shadcn.com's /improve skill 🫶, and also: - Better monorepo & MFE compatibility - Fixed startTransition support in @reactrouter.com v7+ (while loaders run) Also, we have a changelog page now: nuqs.dev/changelog

"The state of your application, instead of living in memory, lives in the URL." New Señors at Scale episode with @francoisbest.com, creator of nuqs: URL state internals, npm supply chain attacks, and AI agents in open source. 🎥 https://youtu.be/b3AYuuRdyf4 #React #nuqs

✍️ New blog post: how I refactored the @nuqs.dev release pipeline for npm staged publishing. nuqs.dev/blog/staged-... Also some relevant supply-chain security advice for GitHub Actions & npm package consumers. (words written by hand, with some LLM assistance for supporting diagrams)

When people say that "@nuqs.dev just works": this is why. app.principal-ade.com/47ng/nuqs

📦 nuqs@2.9.0 is out! 🚀 - Added support for @reactrouter.com v8 - Added `history` as a global default at the adapter level 🐞 Plus lots of bug fixes, check out our new changelog page: nuqs.dev/docs/changel... Try it out: pnpm add nuqs@latest

The new reality of open-source at the age of AI: - 📈 Downloads going up (3M weekly for @nuqs.dev) - 📉 Human engagement (visit to the docs, stars, issues & discussions) going down. I’ll be talking about this in my talk next week at @forkit.community

Staged publishing TL;DR 1. You replace `npm publish` with `npm stage publish` 2. It puts the tarball in a staging area for review 3. You approve it via the CLI or web It will land in npm@^11.15.0. I've already turned off non-staged publishing in @nuqs.dev (in the Trusted Publishing settings).

Tomorrow on stream I'll be unveiling a new @nuqs.dev API. Your URL state is about to become much cleaner, type-safe, and easier to scale. 10am CET. twitch.tv/francoisbest

📦 nuqs@2.8.9 is out! 🚀 It fixes a warning in @nodejs.org 25 related to localStorage access on the server (TIL Node.js is adding this API 👀). You can now enable debug logs server-side with the env var DEBUG="nuqs" (or any string that contains it). Try it out: pnpm add nuqs@latest

Type-Safe URL State Management with @francoisbest.com! The URL is a powerful hidden state manager. Learn to use nuqs for type-safe URL state with teleportation and time travel capabilities. Watch the talk: https://gitnation.com/contents/type-safe-url-state-management-in-react-with-nuqs

📦 nuqs@2.8.8 is out! 🚀 🐞 It fixes a bug with @nextjs.org app router where URL state would leak during navigation (destination page pre-rendered with the source page's search params). Try it out: pnpm add nuqs@latest

📦 nuqs@2.8.7 is out! 🚀 🐞 It fixes a bug with @reactrouter.com 6/7 & @remix.run with Link & Back navigation, where the source page would briefly re-render with the destination URL state before unmounting. Try it out: pnpm add nuqs@latest

🟦 #WORKSHOP DAY - Just Confirmed 😉 👨🏻‍💻 Level Up Your URL State In Next.js With @nuqs.dev 👨🏻‍💻with @francoisbest.com Learn More & Save Your Seat NOW! ⚠️Limited Seats 👉🏼 react.paris

nuqs has reached TEN THOUSAND STARS 🤯 Insane. Thank you so much, y'all! 🫶

The @nuqs.dev types in TypeSlayer 😈 Happy new year! 🎆🎇

2025 was an incredible year for @nuqs.dev, but the best part was the friends we made along the way. 🫶 Happy new year! 🥂

🟣 on Tuesday stream we'll be adding an e2e test suite for the @nuqs.dev Waku adapter targeting v1@alpha. This is the "graduation ceremony" towards becoming the 8th official adapter! 🎉⛩️

Merry Christmas everyone! 🎄🎅🎁

I tried Claude Code this weekend to rewrite the @nuqs.dev e2e test suite from Cypress to Playwright. LoC wise, this was a 80% 🤖 / 20% 👨‍💻 But prep was about 80% 🧠 / 20% 🤖 I prepared a few example tests, shared abstractions and metadata (deps, config) by hand, and left the grunt work to the bots.

📦 nuqs@2.8.6 is out! 🚀 Type-level bug fix: the `LoaderOptions` type was deprecated in favour of `CreateLoaderOptions`, which wasn't exported (it is now). Try it out: pnpm add nuqs@latest

I see a lot of AI slop articles about @nuqs.dev on LinkedIn, but this one tops it all. 🤦‍♂️ The article also ends up with the usual follow-up: "would you like to add any other sections to the blog post, such as…" 🫠

nuqs has reached 40M downloads (all-time) 📈 Thank you all! 🫶

📺 Video is up! In 1h30 we built a @nuqs.dev adapter for @redwoodjs.com, with: - Client hook (read + write) - Server-side loading - Declarative client/server state location (with the shallow option) - Full type-safe linking (pathname + search params) Code & links in the description ⬇️

Coming next year: @nuqs.dev workshops. I come to your company (in person or remote), and: - Evaluate how your app could improve with URL state - Show you how to use nuqs efficiently for your domain - Level up your team with best practices Interested? DMs are open.

📦 nuqs@2.8.5 is out! 🚀 It fixes a bug with useQueryStates where passing undefined for a key would try and serialise it. - undefined means "leave as-is" - null means "remove from the URL" - any other value sets the state & updates the URL Try it out: pnpm add nuqs@latest

Fun fact: @nuqs.dev means “What!?” in Klingon 🖖

📦 nuqs@2.8.4 is out! 🚀 It removes the "use client" directive from .d.ts files, which could cause issues when "skipLibCheck" wasn't set in your @typescriptlang.org config. It also fixes an internal script to build the repo on Windows. Try it out: pnpm add nuqs@latest

📦 nuqs@2.8.3 is out! 🚀 🐞 It fixes a bug where the processUrlSearchParams middleware wasn’t called on debounced updates. Try it out: pnpm add nuqs@latest

📦 nuqs@2.8.2 is out! 🚀 Just a little internal fix on detecting multiple versions being loaded at the same time (very rare). Most importantly, it adds @dominikdoesdev.bsky.social & databuddy.cc to the sponsors list 💖 Try it out: pnpm add nuqs@latest

This Friday @reactadvanced.gitnation.org London, I got to see @francoisbest.com's talk on #nuqs for the second time! The last time was actually his first talk at @forkit.community Rouen 2024. Inspiring to see how far he's come 📖✍️ and to witness the crowd react with such amazement! Congrats man!

we all love @nuqs.dev 💙 thank you @francoisbest.com for supporting @pkg.pr.new. and a huge shoutout to @ariperkkio.dev for suprising me with this one.

I'm signing the @opensourcepledge.com, it's time to give back to the maintainers of the projects @nuqs.dev depends on. I just gave 2700€ ($3,212) to 18 maintainers & projects I use, love, and want to support. Happy Thanksgiving! 💖 nuqs.dev/blog/open-so...

Join the @reactadvanced.gitnation.org live stream on Friday 28th! 🗣️👀 reactadvanced.com

📦 nuqs@2.8.1 is out! 🚀 🐞 It fixes two bugs with @tanstack.com Router: - Trailing slash is no longer added on state updates - Custom history.state is maintained Try it out: pnpm add nuqs@latest

The State of React survey is out! 🔗 survey.devographics.com/en-US/survey... You know what to do 👀

I have an idea for my @reactadvanced.gitnation.org talk that would requiring building and shipping a new feature in @nuqs.dev next week (so I can actually rehearse with it). Conference-driven development is real.

Yesterday I quietly released @nuqs.dev 2.8.0 No big new feature, but a widening of the SemVer range for react-router{-dom} to include v5, as I need it in a client project. Might be removed in nuqs@3.0.0, we'll see how support goes. The adapter can be installed with the @shadcn.com CLI:

The @nuqs.dev @shadcn.com registry now has an RSS feed 📡 ✨ Get notified when we drop a new adapter, parser or utility 🐞 or when we push updates & bug fixes nuqs.dev/registry It now contains community adapters, to one-command install nuqs in: ⛩️ Waku 🐘 Inertia 🥇 One.js 📱 Expo Router (coming soon)

📦 nuqs@2.7.3 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.