next.js/examples/with-react-i18next/README.md

Internationalization with react-i18next.

How to use

Using create-next-app

Execute create-next-app with Yarn or npx to bootstrap the example:

npx create-next-app --example with-react-i18next with-react-i18next-app
# or
yarn create next-app --example with-react-i18next with-react-i18next-app

Download manually

Download the example:

curl https://codeload.github.com/zeit/next.js/tar.gz/master | tar -xz --strip=2 next.js-master/examples/with-react-i18next
cd with-react-i18next

Install it and run:

npm install
npm run dev
# or
yarn
yarn dev

Deploy it to the cloud with now (download)

now

Testing the app

auto detecting user language: http://localhost:3000

german: http://localhost:3000/?lng=de

english: http://localhost:3000/?lng=en

The idea behind the example

This example app shows how to integrate react-i18next with Next.

Plus:

• Routing and separating translations into multiple files (lazy load them on client routing)
• Child components (pure or using translation hoc)

Features of this example app

• Server-side language negotiation
• Full control and usage of i18next on express server using i18next-express-middleware which asserts no async request collisions resulting in wrong language renderings
• Support for save missing features to get untranslated keys automatically created locales/{lng}/{namespace}.missing.json -> never miss to translate a key
• Proper pass down on translations via initialProps
• Taking advantage of multiple translation files including lazy loading on client (no need to load all translations upfront)
• Use express to also serve translations for clientside
• In contrast to react-intl the translations are visible both during development and in production

learn more

• next.js
• react-i18next repository
• react-i18next documentation

Translation features:

• i18next repository
• i18next documentation

Translation management:

• locize