@shopify/react-i18n-universal-provider
TypeScript icon, indicating that this package has built-in type declarations

3.1.0 • Public • Published

@shopify/react-i18n-universal-provider

Build Status Build Status License: MIT npm version npm bundle size (minified + gzip)

A self-serializing/deserializing i18n provider that works for isomorphic applications.

Installation

yarn add @shopify/react-i18n-universal-provider

Usage

Props

The component takes an object containing the React children to render and any options to use when configuring the I18nManager to provide to the tree.

The <I18nUniversalProvider> takes the following props:

// from @shopify/react-i18n
I18nDetails {
    locale: string;
    country?: string;
    currency?: string;
    timezone?: string;
    pseudolocalize?: boolean;
    fallbackLocale?: string;
    onError?(error: I18nError): void;
}

Example

// App.tsx
import {I18nUniversalProvider} from '@shopify/react-i18n-universal-provider';

function App({locale}: {locale?: string}) {
  return (
    <I18nUniversalProvider locale={locale}>
      {/* rest of the app */}
    </I18nUniversalProvider>
  );
}

Possible Issues

Missing i18n manager error

Error: Missing i18n manager. Make sure to use an <I18nContext.Provider /> somewhere in your React tree from the @shopify/react-i18n hook.
Cause:

Duplicate and/or unmet versions of react-i18n

Potential Solution:

Deduplicating dependencies for react-i18n-universal-provider and react-i18n.

npx yarn-deduplicate --packages @shopify/react-i18n yarn.lock
npx yarn-deduplicate --packages @shopify/react-html yarn.lock
npx yarn-deduplicate --packages @shopify/react-effect yarn.lock
# deduplicate other dependencies of @shopify/react-i18n
yarn why @shopify/react-i18n # ensure no duplicate / unmet dependencies
yarn list  # ensure no duplicate / unmet dependencies
yarn install

Readme

Keywords

none

Package Sidebar

Install

npm i @shopify/react-i18n-universal-provider

Weekly Downloads

5,320

Version

3.1.0

License

MIT

Unpacked Size

12.9 kB

Total Files

20

Last publish

Collaborators

  • jaimie.rockburn
  • blittle
  • shopify-admin
  • maryharte
  • crisfmb
  • pmoloney89
  • netlohan
  • st999999
  • justin-irl
  • megswim
  • wcandillon
  • nathanpjf
  • shopify-dep
  • goodforonefare
  • lemonmade
  • vsumner
  • wizardlyhel
  • antoine.grant
  • tsov
  • andyw8-shopify
  • henrytao
  • hannachen
  • vividviolet
  • bpscott