Автор:
    Создание:2026-06-13Последнее обновление:2026-06-13

    Migrate from i18n-js to Intlayer

    Transitioning from the i18n-js library to Intlayer is a highly optimized migration designed to offload large translations configurations into Intlayer's structured file resolution system.

    What to do

    Execute the following setup command in your repository:

    bash
    npx intlayer init

    With intlayer.config.ts prepared, you can add Intlayer's alias to your bundler configuration so that any imports of i18n-js target the compat package @intlayer/i18n-js.

    What it does under the hood

    i18n-js accesses namespaces through expressions like i18n.t('scope.key', {name}) along with locale fallbacks and specific plural mappings.

    Under the hood:

    • Interpolation: The compat adapter easily parses %{name} mappings into your targeted runtime dictionary value.
    • Pluralization: Replaces one/other subkeys and maps them against Intlayer's powerful underlying plural mechanisms (Intl.PluralRules), abstracting away manual mappings.
    • Locales: Instead of loading monolithic language payloads at bootstrap, dictionaries are served up optimally based on the current context setup via the native Intlayer configuration.