Who better to teach you nuqs than the person who built it? François Best spent 8 years in the audio industry building hardware before switching to web dev — and then created nuqs, the go-to library for type-safe URL state management in NextJs (and beyond).

In this episode, François walks us through a live demo of nuqs from the basics to the advanced — custom parsers, shallow vs. network updates, the declarative search params pattern for end-to-end type safety between client and server, rate limiting (aka "time safety"), testing adapters, and more.

Whether you're just replacing useState with useQueryState or architecting full-stack filter systems with server-side loaders, this one's packed with patterns you can use today.

📚 Resources
🔗 nuqs docs: https://nuqs.dev
🔗 François on Twitter/X: https://x.com/nuqs47ng

🎤 NextJs conf 2025
🔗 https://www.youtube.com/watch?v=qpczQVJMG1Y

⏳ Chapters
00:00 François Best's Journey into Web Development
04:48 The Concept of URL as State Management
10:28 Next.js Evolution and Nux Integration
13:59 Deep Dive into Nux Functionality
33:59 Summarizing Nux's Benefits and Patterns
36:03 Understanding Type Safety and Time Safety
45:52 Optimizing URL Updates and User Experience
54:06 Creating Type-Safe Links and Custom Parsers
01:04:10 Advanced URL Management Techniques
01:12:50 Testing and Future Enhancements

Hamed Bahram

A deep-dive interview and live coding session with François Best, creator of nuqs, covering URL state management in Next.js. The session walks through nuqs fundamentals—replacing useState with useQueryState, using parsers for type safety, and the nuqs/nuqs-server import distinction for React Server Components. Advanced patterns include creating a shared search params descriptor object to derive type-safe loaders, hooks, and link generators; controlling shallow vs. deep (server-triggering) updates; debounce and throttle options for rate-limiting URL updates ('time safety'); and integrating React's useTransition for optimistic UI feedback. The creator also discusses Next.js App Router specifics like async search params, cache component boundaries, and the donut pattern for mixing server and client components.

Master nuqs in 1 hour — URL state in NextJs with creator François Best