🗺️ Roadmap
Note: I don't update this often, it may contain stale references.
Coming up
Library
Research phase:
Docs
- Rename the "playground" into a "recipes" section
- Showcase a complete pagination + filtering + ordering/sorting example with data fetching (no artificial delay). Maybe using shadcn table.
- Figure out how to add interactive (editable + runnable) demos of the hooks, client-side only. HMR in prod?
🚀 Changelog
🗣️ Changelog now lives in the docs: https://nuqs.dev/changelog
2.7.2
2.7.1
2.7.0
⚠️ Deprecations:
ParserBuilder<T> is deprecated in favor of SingleParserBuilder<T>. Use SingleParserBuilder going forward.
Features:
Bug fixes:
Documentation
Other changes:
2.6.0
Features:
Documentation:
Other changes:
2.5.2
2.5.1
2.5.0
See blog post: https://nuqs.47ng.com/blog/nuqs-2.5
Features:
Bug fixes:
Documentation:
Other changes:
2.4.3
2.4.2
2.4.1
2.4.0
2.3.2
2.3.1
2.3.0
2.2.3
2.2.2
2.2.1
2.2.0
2.1.2
2.1.1
2.1.0
2.0.4
2.0.3
2.0.2
2.0.1
2.0.0
1.20.0
1.19.3
1.19.2
1.19.1
1.19.0
1.18.0
1.17.8
1.17.7
1.17.6
1.17.5
1.17.4
1.17.3
1.17.2
- fix: Don't rely on URL for initial state (9912eef)
1.17.1
1.17.0
1.16.1
1.16.0
1.15.4
1.15.3
1.15.2
1.15.1
Fixes a bug where debugging information would only show when using next-usequerystate (not nuqs) in localStorage.debug.
1.15.0
1.14.1
1.14.0
Project rebranding to nuqs - #438
1.13.2
1.13.1
Released when Next.js 14.0.4 landed with the shallow routing fix in vercel/next.js#58861
1.13.0
1.12.2
Released when Next.js 14.0.3 landed with the prefetch fix in vercel/next.js#58297.
1.12.1
1.12.0
1.11.0
- Handle higher rate limits on Safari (~100ms for 17+, ~300ms for older versions)
- Allow catching unapplied search params when rate-limited
- URLs to docs in errors
1.10.0
🗺️ Roadmap
Coming up
Library
read current search params(loaders: feat: Add loader feature #818) and set them to the URL in a one-off way (outside of a React hook context), using the same parsers and options.Add a global default options context provider→ probably not neededResearch phase:
router.refreshon shallow updates (resets the query string). Solutions are to use non-shallow updates, or to enable WHS. See wrong url after refresh page #392 (comment) → This needs a test to ensure whether this behaviour is still present or not.Docs
🚀 Changelog
🗣️ Changelog now lives in the docs: https://nuqs.dev/changelog
2.7.2
2.7.1
2.7.0
ParserBuilder<T>is deprecated in favor ofSingleParserBuilder<T>. UseSingleParserBuildergoing forward.Features:
Bug fixes:
Documentation
Other changes:
2.6.0
Features:
Documentation:
Other changes:
2.5.2
2.5.1
2.5.0
See blog post: https://nuqs.47ng.com/blog/nuqs-2.5
Features:
constmodifier to literal parsers to auto-infer their arguments as literals #1038Bug fixes:
Documentation:
Other changes:
2.4.3
2.4.2
2.4.1
2.4.0
parseAsPageIndexparser #791shallow: falseupdates in React SPA #8912.3.2
2.3.1
2.3.0
Nullabletype for correctly inferring return type ofcreateSerializer()#801?characters in serializer base #8212.2.3
2.2.2
2.2.1
nullvalue in serializer for parsers with default values #7692.2.0
2.1.2
2.1.1
2.1.0
2.0.4
2.0.3
2.0.2
2.0.1
2.0.0
1.20.0
nullto clear all param values from base #6571.19.3
UrlSearchParamsclasses #6471.19.2
createSerializer#6421.19.1
1.19.0
1.18.0
1.17.8
1.17.7
1.17.6
1.17.5
1.17.4
1.17.3
1.17.2
1.17.1
1.17.0
1.16.1
1.16.0
1.15.4
nextinternal as optional #4651.15.3
1.15.2
nextproperty on window #4561.15.1
Fixes a bug where debugging information would only show when using
next-usequerystate(notnuqs) inlocalStorage.debug.1.15.0
1.14.1
1.14.0
Project rebranding to
nuqs- #4381.13.2
history: "push"was broken for pages router)1.13.1
Released when Next.js 14.0.4 landed with the shallow routing fix in vercel/next.js#58861
subscribeToQueryUpdates#4251.13.0
1.12.2
Released when Next.js 14.0.3 landed with the prefetch fix in vercel/next.js#58297.
latest(and update branch protection to match)next@latest. See Resets to initial state when there is Link with prefetch #388.1.12.1
console.log#3981.12.0
1.11.0
1.10.0