@nuxtjs/i18n

This release is mostly about performance, and about making the domain features behave consistently.

Faster builds and faster SSR

Locale messages are no longer bundled into your server build as JavaScript, no longer shipped as client chunks when they are served from the messages endpoint, and no longer copied on every server-rendered request.

Building a Nuxt app with 10 locales of around 2,000 messages each and 10 pages:

Median of three runs on an M4 Pro with Nuxt 4.5; throughput over 10 concurrent connections. The same app without the module builds in 3.4s and outputs 3.2 MB.

How much of this you notice depends on how many messages your app loads: a few locales with a few hundred messages each will barely differ, larger message sets gain the most. It covers messages the module can read while building — .json, .yaml and .json5 files. Locale files written as .ts or .js produce their messages at runtime, so both their build and their SSR cost stay as they were. Apps that previously ran out of memory building large message sets should now complete.

This should work without any changes on your side. The new message handling can be turned off with experimental.optimizeMessageBundling: false if you run into trouble — and if you do, please let us know so we can sort it out.

Domains

differentDomains and multiDomainLocales now agree on which locale each domain serves, which URL a locale is advertised on, and where a visitor goes when the locale they asked for lives on another domain. hreflang and canonical links name one domain per locale, so every domain in your setup describes the same set of pages instead of each claiming the languages for itself.

10.5.0 could also stop serving a locale at its own domain root, redirecting / to the prefixed path and returning 404 for unprefixed paths. A domain that serves exactly one locale is treated as that locale's default again, so domainDefault is not needed for it.

Changelog

Features

• Add experimental.optimizeMessageBundling option

• domain: Restrict locales to a subset of domains

Bug Fixes

• Strip protocol when matching domain to host

• Let vue-router encode switchLocalePath paths

• Load locale files that use Nuxt app composables in the app

• Keep params encoded when resolving a localized route by path

• bundler: Only precompile locale files the resource transform can re-emit

• domain: Resolve locale availability from host membership

• domain: Resolve links for the host default locale under prefix_and_default

• domain: Resolve domain config the same way at build time and runtime

• domain: Resolve the current origin from the host

• domain: Redirect detection to the domain serving the detected locale

• domain: Resolve a domain serving a single locale as its default

• domain: Serve every locale on a host matching no configured domain

• hmr: Use virtual module ids in import.meta.hot.accept() for vite 8

• routing: Resolve the unprefixed locale per domain

• seo: Emit the same x-default on every domain

• seo: Warn when a domain setup has no locale to annotate as x-default

• seo: Resolve alternate and canonical links from one domain per locale

• types: Narrow locale head types to support useHeadSafe

• types: Annotate the logger so its declaration stays portable

• types: Prevent duplicate tsconfig paths for aliased deps

Performance

• Skip client locale chunks when using messages endpoint

• Keep locale messages out of server build graphs

• Avoid copying locale messages per ssr request

• Enable experimental.optimizeMessageBundling by default

• Keep message caching enabled for static locales in mixed projects