Skip to content

feat: Add support for more global default options at the adapter level#1079

Merged
franky47 merged 3 commits intonextfrom
feat/more-global-options
Aug 20, 2025
Merged

feat: Add support for more global default options at the adapter level#1079
franky47 merged 3 commits intonextfrom
feat/more-global-options

Conversation

@franky47
Copy link
Member

@franky47 franky47 commented Aug 19, 2025

Supported:

  • shallow defaults to true, change to false to always send notifications to the server on updates
  • scroll defaults to false, change to true to always scroll to the top of the page after an update
  • clearOnDefault defaults to true, change to false to always write values to the URL, even when set to the default value (explicit defaults)
  • limitUrlUpdates defaults to a custom throttle rate for your browser, increase it here if need be (debouncing at the top level is not recommended).

Tasks

  • Fix props forwarding in the React SPA file adapter, and check the others

cc @TkDodo

Supported:
- `shallow` defaults to `true`, change to `false` to always send
notifications to the server on updates
- `scroll` defaults to `false`, change to `true` to always scroll to
the top of the page after an update
- `clearOnDefault` defaults to `true`, change to `false` to always
write values to the URL, even when set to the default value (explicit defaults)
- `limitUrlUpdates` defaults to a custom throttle rate for your browser,
increase it here if need be (debouncing at the top level is not recommended).
@franky47 franky47 added the feature New feature or request label Aug 19, 2025
@franky47 franky47 added this to the 🪵 Backlog milestone Aug 19, 2025
@vercel
Copy link

vercel bot commented Aug 19, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
nuqs Ready Ready Preview Comment Aug 20, 2025 6:43am

@pkg-pr-new
Copy link

pkg-pr-new bot commented Aug 19, 2025

pnpm add https://pkg.pr.new/nuqs@1079

commit: 06d4baa

@franky47 franky47 merged commit 824c918 into next Aug 20, 2025
29 checks passed
@franky47 franky47 deleted the feat/more-global-options branch August 20, 2025 11:07
@github-actions
Copy link

🎉 This PR is included in version 2.5.0-beta.7 🎉

The release is available on:

Your semantic-release bot 📦🚀

@github-actions
Copy link

🎉 This PR is included in version 2.5.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

@franky47 franky47 removed this from the 🚀 Shipping next milestone Aug 22, 2025
@franky47 franky47 mentioned this pull request Aug 25, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants