feat: Add Expo Router adapter

[SergGrey1992]

🇬🇧 English

Feature Request: Expo Router Adapter

nuqs currently supports the following adapters:

• Next.js (App Router / Pages Router)
• React SPA (e.g. Vite)
• Remix
• React Router v6 / v7
• TanStack Router

However, there is no adapter for Expo Router —
the official file-based router for Expo / React Native apps.

Motivation

Expo Router is rapidly becoming the standard for universal React Native apps
(iOS, Android, and Web). It follows a URL-based navigation model similar to Next.js App Router,
making it a natural fit for nuqs-style query state management.

Developers building universal apps need a way to sync state with URL search params —
especially on the Web target, where the URL is fully supported.

Expected API

// app/_layout.tsx
import { NuqsAdapter } from 'nuqs/adapters/expo-router'
import { Slot } from 'expo-router'

export default function RootLayout() {
  return (
    
      
    
  )
}

Possible Implementation

An Expo Router adapter could be built using:

• useRouter() → for router.setParams() / router.replace() to update search params
• useLocalSearchParams() / useGlobalSearchParams() → to read current search params

Environment

• nuqs version: latest (2.x)
• Expo Router version: v4
• Expo SDK: 52+
• Platforms: iOS / Android / Web

[franky47]

Please try out the experimental adapter in #837, I'd love your feedback on it.

(there are a few variants throughout the thread)