Installation
Getting started
Install the nuqs package with your favourite package manager:
npm install nuqsWhich version should I use?
nuqs@^2 supports the following frameworks and their respective versions:
- Next.js: 14.2.0 and above (including Next.js 15)
- React SPA: 18.3 & 19
- Remix: 2 and above
- React Router v6:
react-router-dom@^6 - React Router v7:
react-router@^7 - TanStack Router:
@tanstack/react-router@^1
For older versions of Next.js, you may use nuqs@^1 (documentation in the
README).