nuqs

@nuqs.dev

Type-safe search params state manager for React frameworks. Like useState, but stored in the URL query string. Made by @francoisbest.com & contributors 🔗 https://nuqs.dev

📦 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

Install nuqs@latest using your favourite package manager.

📦 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

Install nuqs@latest using your favourite package manager

📦 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

📦 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

?n=u&q=s - Type-Safe Search Params State Manager for React
npm i
pnpm add
yarn add
bun 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

?n=u&q=s - Type-Safe Search Params State Manager for React
npm i
pnpm add
yarn add
bun add
nuqs@latest

🟣 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! 🎉⛩️

Daishi Kato@daishikato.com · 7mo ago

Waku v1 Alpha Is Finally Released Nearly Three Years in the Making newsletter.daishikato.com/p/waku-v1-al... - It's a React framework developed for React Server Components from day one. - It's based on Vite and Hono. - Its API is small and easy to learn. 👉 waku.gg ⛩️

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 - Type-safe search params state manager for React

Cypress ➡️ Claude ➡️ Playwright

📦 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

?n=u&q=s - Type-Safe Search Params State Manager for React
npm i
pnpm add
yarn add
bun 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…" 🫠

Here is the revised « why choose nuqs? » section in a clean, Markdown-formatted table, ready for you to copy and paste directly into your dev.to blog post.

## Why choose nuqs?

📺 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 ⬇️

Making a custom nuqs adapter for RedwoodSDK

YouTube video by 47ng

youtube.com

François Best@francoisbest.com · 8mo ago

🟣 I'm live on Twitch! Adding @nuqs.dev to @redwoodjs.com (the @cloudflare.social RSC framework), come say hi! 👋 twitch.tv/fortysevenfx

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 - Type-safe search params state manager for React

Workshops
Levelling up your team's URL state managment

COMING SOON