Getting started

@vuqs/nuxt auto-imports the composables and codecs, and provides the vue-router adapter app-wide.

Install

pnpm add @vuqs/core @vuqs/nuxt

Register it in nuxt.config:

// nuxt.config.ts
export default defineNuxtConfig({
  modules: ['@vuqs/nuxt'],
})

The composables and codecs are now auto-imported, and the adapter is installed app-wide:

<script setup lang="ts">
const search = useQueryState('q', codecs.string.withDefault(''))
</script>

<template>
  <input v-model="search">
</template>

Registered APIs

• Auto-imports: the composables, the codecs namespace, and the modules.
• The adapter: the vue-router adapter, installed on the Vue app so every composable resolves it.

Use vuqs configuration to select auto-import groups, set adapter defaults, or disable the built-in adapter.

Compatibility

Works with Nuxt 3 and Nuxt 4 (compatibility: { nuxt: '>=3.0.0' }).