{% import "../../readmeMacros/macros.njk.md" as macros %}

{{ macros.header('Tolgee i18next integration', 'A package enabling you to use i18next with Tolgee', packageName) }}

What's the Tolgee i18next package?

Using i18next, but want to use cool Tolgee features like in-context editing or automated screenshot generation? No worries. Tolgee i18next integration is here for you!

{{ macros.integrationLinks('Tolgee i18next docs', macros.v5link('integrations/i18next/installation')) }}

{{ macros.installation('i18next') }}

Usage

First, create a Tolgee instance and wrap your i18next instance withTolgee.

import i18n from 'i18next';
import { withTolgee, Tolgee, I18nextPlugin, FormatSimple } from '@tolgee/i18next';

const tolgee = Tolgee()
  .use(I18nextPlugin())
  .use(FormatSimple())
  .init({
    apiUrl: ...,
    apiKey: ...,
  });

withTolgee(i18n, tolgee)
  .use(...)
  .init(...)

Language changing

Tolgee will automatically switch language accordingly to i18next. So to get current language do:

const lang = i18n.lang;

To set language:

i18n.changeLanguage(lang);

To learn more, check Tolgee documentation.

{{ macros.why() }}

Development

{{ macros.developmentInstallation() }} {{ macros.development('react-i18n') }}

{{ macros.developmentTesting('/packages/i18next') }}

{{ macros.contributors() }}