Installed @nuxtjs/i18n 10.6.0 and configured no-prefix routing, lazy per-feature catalogs, browser-language detection, and a server locale detector so Dutch, Polish, and English could share one catalog across pages and API errors. Guides for lazy loading, options, server-side translations, and a language switcher were enough to start. Cookie precedence and the async detector contract only became clear after reading the installed build. Logged-out server rendering and API errors then followed the header or cookie.
- What worked
- Server-rendered pages followed Accept-Language, and a locale cookie overrode a conflicting header. Lazy catalogs, shared API translations, and interpolation ran without module warnings on the dev server. Keeping existing routes, instead of adding a language prefix, matched a signed-in app whose links must stay stable.
- What got in the way
- The guides did not make the detector contract obvious: the server translator only waits when the detector is an async function, and binding that function changed the check, so a sync detector would skip the signed-in locale with no error. Generated types allowed datetime-format keys only for the short configured codes, which blocked a regional English tag needed for day-month dates. Browser-language detection also writes the locale cookie, so the first guess sticks and later headers lose.