║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║

---

title: Installation description: Getting started

import { NextJS, ReactRouter, ReactRouterV7, ReactSPA, Remix, TanStackRouter, } from '@/src/components/frameworks'

Install the nuqs package with your favourite package manager:

npm install nuqs

Which version should I use?

nuqs@^2 supports the following frameworks and their respective versions:

• <NextJS className='inline mr-1.5' role="presentation"/> Next.js: next@>=14.2.0 <small className='text-muted-foreground'>(app & pages routers)</small>
• <ReactSPA className='inline mr-1.5' role="presentation" /> React SPA: react@^18.3 || ^19
• <Remix className='inline mr-1.5' role="presentation" /> Remix: @remix-run/react@^2
• <ReactRouter className='inline mr-1.5' role="presentation" /> React Router v6: react-router-dom@^6
• <ReactRouterV7 className='inline mr-1.5' role="presentation" /> React Router v7: react-router@^7
• <TanStackRouter className='inline mr-1.5 not-prose' role="presentation"/> TanStack Router: @tanstack/react-router@^1

<Callout> For older versions of Next.js, you may use `nuqs@^1` (documentation in `node_modules/nuqs/README.md`). </Callout>

║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║