Migra da next-i18next a Intlayer

Per un tutorial completo e dettagliato passo dopo passo, consulta la nostra Guida alla migrazione da next-i18next.

Intlayer gestisce tutte le implementazioni di Next.js Pages Router e App Router in modo trasparente. Utilizzando l'adapter puoi migrare la tua implementazione next-i18next senza riscrivere il codice.

Cosa fare

Per iniziare, esegui:

npx intlayer init

Questo crea il file di configurazione Intlayer necessario. Per integrare Intlayer dietro le quinte, aggiorna il tuo next.config.ts:

import type { NextConfig } from "next";import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";const withIntlayer = createNextI18nPlugin();const nextConfig: NextConfig = {};export default withIntlayer(nextConfig);

Come funziona internamente

Il createNextI18nPlugin combina il comportamento nativo di Next.js insieme al plugin core next-intlayer, iniettando tutti gli alias Webpack/Turbopack richiesti per next-i18next, react-i18next e i18next.

Internamente:

• serverSideTranslations & appWithTranslation: Ora funzionano come wrapper per i loader interni di Intlayer, evitando l'iniezione di grandi JSON statici.
• Client hooks: Delega immediatamente a @intlayer/react-i18next mantenendo tutti i formati, i plurali e le funzionalità degli spazi dei nomi annidati.