nuqs's Avatar

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

363
Followers
1
Following
82
Posts
31.10.2024
Joined
Posts Following

Latest posts by nuqs @nuqs.dev

Preview
Twitch Twitch is the world

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

05.03.2026 14:56 πŸ‘ 5 πŸ” 1 πŸ’¬ 0 πŸ“Œ 1

πŸ“¦ 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

27.02.2026 18:27 πŸ‘ 7 πŸ” 1 πŸ’¬ 0 πŸ“Œ 0
Post image

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

18.02.2026 14:02 πŸ‘ 11 πŸ” 2 πŸ’¬ 0 πŸ“Œ 0
?n=u&q=s - Type-Safe Search Params State Manager for React
npm i
pnpm add
yarn add
bun 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.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

02.02.2026 14:23 πŸ‘ 14 πŸ” 1 πŸ’¬ 0 πŸ“Œ 0
?n=u&q=s - Type-Safe Search Params State Manager for React
npm i
pnpm add
yarn add
bun 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

30.01.2026 15:53 πŸ‘ 9 πŸ” 1 πŸ’¬ 0 πŸ“Œ 0
Post image

🟦 #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

30.01.2026 10:34 πŸ‘ 7 πŸ” 2 πŸ’¬ 0 πŸ“Œ 3
?n=u&q=s, Type-safe search params state manager for React
10,000 stars on GitHub: 47ng/nuqs

?n=u&q=s, Type-safe search params state manager for React 10,000 stars on GitHub: 47ng/nuqs

nuqs has reached TEN THOUSAND STARS 🀯

Insane. Thank you so much, y'all! 🫢

23.01.2026 22:38 πŸ‘ 11 πŸ” 0 πŸ’¬ 0 πŸ“Œ 1

The @nuqs.dev types in TypeSlayer 😈

Happy new year! πŸŽ†πŸŽ‡

02.01.2026 08:02 πŸ‘ 13 πŸ” 1 πŸ’¬ 1 πŸ“Œ 0
Preview
2025 | nuqs A look back on an amazing year of OSS, meeting people, and milestones.

2025 was an incredible year for @nuqs.dev, but the best part was the friends we made along the way. 🫢

Happy new year! πŸ₯‚

31.12.2025 15:55 πŸ‘ 12 πŸ” 1 πŸ’¬ 0 πŸ“Œ 0

🟣 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! πŸŽ‰β›©οΈ

26.12.2025 07:47 πŸ‘ 9 πŸ” 1 πŸ’¬ 0 πŸ“Œ 0
A Christmas-themed AI-generated artwork of the nuqs logo. The ? is a candy cane, the n is wrapped in lights, the = is a pair of logs covered in snow, the u is filled with baubles, the & is a wreath, the q has a santa hat and a glowing star atop, the = is two candy canes, and the s is another wreath. A lit up Christmas tree and snowflakes in the background

A Christmas-themed AI-generated artwork of the nuqs logo. The ? is a candy cane, the n is wrapped in lights, the = is a pair of logs covered in snow, the u is filled with baubles, the & is a wreath, the q has a santa hat and a glowing star atop, the = is two candy canes, and the s is another wreath. A lit up Christmas tree and snowflakes in the background

Merry Christmas everyone! πŸŽ„πŸŽ…πŸŽ

25.12.2025 09:34 πŸ‘ 5 πŸ” 0 πŸ’¬ 0 πŸ“Œ 1
nuqs - Type-safe search params state manager for React

Cypress ➑️ Claude ➑️ Playwright

nuqs - Type-safe search params state manager for React Cypress ➑️ Claude ➑️ Playwright

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.

22.12.2025 19:11 πŸ‘ 15 πŸ” 1 πŸ’¬ 1 πŸ“Œ 0
?n=u&q=s - Type-Safe Search Params State Manager for React
npm i
pnpm add
yarn add
bun 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.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

23.12.2025 14:44 πŸ‘ 3 πŸ” 1 πŸ’¬ 0 πŸ“Œ 0
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?

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?

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…" 🫠

16.12.2025 19:02 πŸ‘ 12 πŸ” 1 πŸ’¬ 3 πŸ“Œ 0
<download icon> 40M

<download icon> 40M

nuqs has reached 40M downloads (all-time) πŸ“ˆ

Thank you all! 🫢

19.12.2025 11:12 πŸ‘ 12 πŸ” 1 πŸ’¬ 0 πŸ“Œ 0

πŸ“Ί 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 ⬇️

12.12.2025 15:23 πŸ‘ 2 πŸ” 1 πŸ’¬ 0 πŸ“Œ 0
nuqs - Type-safe search params state manager for React

Workshops
Levelling up your team's URL state managment

COMING SOON

nuqs - Type-safe search params state manager for React Workshops Levelling up your team's URL state managment COMING SOON

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.

09.12.2025 14:21 πŸ‘ 8 πŸ” 2 πŸ’¬ 0 πŸ“Œ 0
?n=u&q=s - Type-Safe Search Params State Manager for React
npm i
pnpm add
yarn add
bun 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.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

10.12.2025 14:23 πŸ‘ 9 πŸ” 2 πŸ’¬ 0 πŸ“Œ 0

Fun fact: @nuqs.dev means β€œWhat!?” in Klingon πŸ––

08.12.2025 09:55 πŸ‘ 4 πŸ” 1 πŸ’¬ 0 πŸ“Œ 0
?n=u&q=s Type-Safe Search Params State Manager for React
npm i
pnpm add
yarn add
bun 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.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

08.12.2025 22:27 πŸ‘ 4 πŸ” 1 πŸ’¬ 0 πŸ“Œ 0
?n=u&q=s - Type-Safe Search Params State Manager for React
npm i
pnpm add
yarn add
bun 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.3 is out! πŸš€

🐞 It fixes a bug where the processUrlSearchParams middleware wasn’t called on debounced updates.

Try it out: pnpm add nuqs@latest

05.12.2025 08:33 πŸ‘ 2 πŸ” 1 πŸ’¬ 0 πŸ“Œ 0
Preview
Privacy-first web analytics (Google Analytics alternative) β€” 3 KB, GDPR-compliant | Databuddy Experience powerful, privacy-first analytics that matches Google Analytics feature-for-feature without compromising user data. Zero cookies required, 100% data ownership, and AI-powered insights to he...

πŸ“¦ 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

01.12.2025 12:10 πŸ‘ 9 πŸ” 1 πŸ’¬ 0 πŸ“Œ 0

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!

30.11.2025 09:56 πŸ‘ 4 πŸ” 2 πŸ’¬ 1 πŸ“Œ 0

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.

27.11.2025 19:21 πŸ‘ 7 πŸ” 1 πŸ’¬ 1 πŸ“Œ 0
Preview
Signing the Open Source Pledge | nuqs Giving back to maintainers of the OSS projects nuqs depends on.

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...

27.11.2025 18:29 πŸ‘ 66 πŸ” 10 πŸ’¬ 5 πŸ“Œ 8

Join the @reactadvanced.gitnation.org live stream on Friday 28th! πŸ—£οΈπŸ‘€

reactadvanced.com

23.11.2025 10:04 πŸ‘ 7 πŸ” 0 πŸ’¬ 0 πŸ“Œ 0
?n=u&q=s Type-Safe Search Params State Manager for React
npm i
pnpm add
yarn add
bun 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.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

21.11.2025 12:01 πŸ‘ 15 πŸ” 3 πŸ’¬ 0 πŸ“Œ 0
What other libraries have you used to manage state in your apps?
nuqs

What other libraries have you used to manage state in your apps? nuqs

The State of React survey is out!

πŸ”— survey.devographics.com/en-US/survey...

You know what to do πŸ‘€

19.11.2025 21:32 πŸ‘ 9 πŸ” 2 πŸ’¬ 1 πŸ“Œ 1

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.

15.11.2025 21:09 πŸ‘ 19 πŸ” 1 πŸ’¬ 1 πŸ“Œ 0
Preview
React Router v5 Adapter | nuqs Using nuqs in React Router v5 applications.

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:

18.11.2025 08:51 πŸ‘ 8 πŸ” 1 πŸ’¬ 1 πŸ“Œ 0