SSR (additional components)

Using Next.js 13 with app directory?

Then check out this article describing how to best internationalize it with i18next.

Using Next.js?

You should have a look at next-i18next which extends react-i18next to bring it to next.js the easiest way.

With next-i18next@v8.0.0 and Next.js v10, next-i18next has done a major rewrite of the package, leveraging the built-in internationalized routing provided by Next.js.

Here you can also find a next-i18next app example in combination with locize, that offers 2 different approaches.

next-i18next@v5.0.0 supports Next.js v9.5 in Serverless mode (as of July 2020). If your goal is to use earlier versions of Next.js with Serverless, then you should have a look at "Next Right Now", which is a Next.js 9 boilerplate with built-in i18next, react-i18next and Locize.

Looking for an optimized Next.js translations setup? Here you'll find a blog post on how to best use next-i18next with client side translation download and SEO optimization.

---

Using SSG / next export? Here you'll find a simple tutorial on how to best use next-i18next in a SSG environment.

Using Remix?

You should have a look at remix-i18next which extends react-i18next to bring it to Remix the easiest way.

Here you'll find a simple example and here a step by step tutorial on how to best use remix-i18next.

Using Gatsby?

You should have a look at gatsby-plugin-react-i18next which extends react-i18next to bring it to Gatsby the easiest way.

Here you'll find a simple example and here a step by step tutorial on how to best use gatsby-plugin-react-i18next.

Setting the i18next instance based on req

Use the I18nextProvider to inject the i18next instance for example bound to the http i18n instance on the request object using i18next-http-middleware.

<I18nextProvider i18n={req.i18n}>
  <App />
</I18nextProvider>

Passing initial translations / initial language down to client

To avoid asynchronous loading of translation on the client side (and the possible Suspense out of that) you will need to pass down initialLanguage (will call changeLanguage on i18next) and initialI18nStore (will prefill translations in i18next store).

using the useSSR hook

import React from 'react';
import { useSSR } from 'react-i18next';

export function InitSSR({ initialI18nStore, initialLanguage }) {
  useSSR(initialI18nStore, initialLanguage);

  return <App />
}

using the withSSR HOC

import React from 'react';
import { withSSR } from 'react-i18next';
import App from './App';

const ExtendedApp = withSSR()(App);

<ExtendedApp initialLanguage={} initialI18nStore={} />

The ExtendedApp in this case will also have the composed ExtendedApp.getInitialProps()