I18n in a React.js app

Looking for a way to streamline collaboration with designers & product managers on content? Tired of making PRs to fix typos in JSON files? Checkout Recontent.app to ship localized content faster.

Installation

git clone git@github.com:recontentapp/example-reactjs-i18n.git

cd example-reactjs-i18n

yarn

yarn start

Adding translations

Translations are stored in JSON files in the src/i18n/locales folder. Each piece of content needs to be referenced in all supported locales.

The t function is typed to prevent using unknown paths within a locale file. The en-GB file is used as a reference of available paths.

Adding new languages

1. Update the Language type in src/i18n/types.ts & languagesLabels constant in src/i18n/constants.ts with the locale you want to support
2. Add a new JSON file in the src/i18n/locales folder which matches the added locale name
3. Import the added JSON file in src/i18n/config.ts & reference it in the resources constant
4. You can now switch your app in that locale

Testing components which rely on translations

You can find an example of such test in src/components/HelpButton.spec.tsx. As i18next is not set up in the test environment, make sure to update mocks declared src/setupTests.ts if you rely on new functions/logic from i18next or react-i18next.

Lazy-loading translations

Translations files tend to grow exponentially as you add new features to your app. Instead of relying on a single i18next namespace which contains all your translations, you can split them in smaller files based on routes (eg. Dashboard) or areas of your app (eg. Admin panel, Public view).