# nuxt-language-negotiation

> Simple language negotiation for Nuxt 3.

Latest version **2.0.2** (published 2025-09-03) · 0 weekly downloads

## Install

```sh
npm install nuxt-language-negotiation
pnpm add nuxt-language-negotiation
yarn add nuxt-language-negotiation
bun add nuxt-language-negotiation
```

## Health

**Score 40/100 (D)** — status: stable.

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types.

Negative: stale.

## Facts

| | |
|---|---|
| Version | 2.0.2 |
| Published | 2025-09-03 |
| First published | 2024-01-31 |
| Weekly downloads | 0 |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 2 |
| Unpacked size | 50.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 3 |
| Author | Jan Hug |
| Maintainers | dulnan |
| Keywords | nuxt, language, i18n, multi-language, translation, internationalization |

## Links

- npm: https://www.npmjs.com/package/nuxt-language-negotiation
- Repository: https://github.com/dulnan/nuxt-language-negotiation
- Homepage: https://github.com/dulnan/nuxt-language-negotiation#readme
- Issues: https://github.com/dulnan/nuxt-language-negotiation/issues
- npm.io page: https://npm.io/package/nuxt-language-negotiation

## Dependencies (2)

- [iso-639-1](https://npm.io/package/iso-639-1.md) ^3.1.5
- [intl-parse-accept-language](https://npm.io/package/intl-parse-accept-language.md) ^1.0.0

## Alternatives

- [messageformat](https://npm.io/package/messageformat.md) — 329.7K weekly downloads
- [@mintlify/scraping](https://npm.io/package/@mintlify/scraping.md) — 294.8K weekly downloads
- [@mintlify/previewing](https://npm.io/package/@mintlify/previewing.md) — 209.5K weekly downloads
- [@mintlify/prebuild](https://npm.io/package/@mintlify/prebuild.md) — 209.5K weekly downloads
- [@mintlify/link-rot](https://npm.io/package/@mintlify/link-rot.md) — 206.3K weekly downloads

## Recent versions

- 2.0.2 (latest) — 2025-09-03
- 2.0.0-alpha.2 (alpha) — 2025-04-23
- 2.0.1 — 2025-07-03
- 2.0.0 — 2025-05-14
- 2.0.0-alpha.1 — 2025-04-21
- 1.0.2 — 2024-05-18
- 1.0.1 — 2024-02-14
- 1.0.0 — 2024-01-31

## README

# Nuxt Language Negotiation

This module provides basic multi-language support for a Nuxt 3 app. It's minimal
by design and tries to do one thing only.

## Features

- SSR language negotiation/detection based on path prefix, `Accept-Language` or
  custom (e.g. via API).
- Single source of truth for "current language" state
- Multi-language routes via `languageMapping` meta property

## What it doesn't do

This module is not a replacement for
[@nuxtjs/i18n](https://github.com/nuxt-modules/i18n) and doesn't aim to be one.
The following features are not provided and are left to the user of the module:

- Translations / localization
- Meta tags / SEO
- Multi domain
- Language switcher
- Multiple strategies (prefix, domain, default)

## Usage

### Setup

```typescript
export default defineNuxtConfig({
  modules: ['nuxt-language-negotiation'],

  languageNegotiation: {
    // Define the available languages.
    availableLanguages: ['en', 'de', 'fr', 'it'],

    // We use two negotiators: Path prefix takes precedence. In cases where no
    // path prefix is available, we fallback to Accept-Language headers.
    negotiators: ['pathPrefix', 'acceptLanguage'],

    // Write debug messages to the console on client and server.
    debug: true,
  },
})
```

### Routing

The module assumes the following:

- Routes generall have a language prefix
  - e.g. `/en/search`, `/de/suche`, etc.
- Routes use a single param for the language prefix
  - e.g. `/:language/product/:id`.
- Routes without a language prefix are required to specify the language via
  route.meta
  - e.g. `/german-landing-page` only available in German, so it defines `de` in
    route.meta.language.
- Routes without a language prefix but with a specific path for every language
  specifiy the mapping via route.meta

This means your pages directory should look like this:

```
pages/
  search.vue
  products/
    [id].vue
    index.vue
  landing-page.vue
  index.vue
```

---
_Source: https://npm.io/package/nuxt-language-negotiation · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
