Ask your question and get a summary of the document by referencing this page and the AI provider of your choice
Version History
- "Init history"v9.0.013/06/2026
The content of this page was translated using an AI.
See the last version of the original content in EnglishIf you have an idea for improving this documentation, please feel free to contribute by submitting a pull request on GitHub.
GitHub link to the documentationCopy doc Markdown to clipboard
Migrate from Polyglot.js to Intlayer
If you are using Airbnb's Polyglot.js, migrating to Intlayer is extremely straightforward using the compat layer.
What to do
Simply run the initialization command in your project:
Copy the code to the clipboard
npx intlayer initThis generates intlayer.config.ts. You can then utilize the bundler plugin alias to transparently redirect Polyglot imports to @intlayer/polyglot.
What it does under the hood
Polyglot.js syntax typically relies on polyglot.t('key', {name}) with %{name} interpolations and smart_count plurals separated by "singular |||| plural".
Under the hood:
- Interpolation: The compat layer handles
%{var}placeholders natively. - Plurals: The string is split at
||||and evaluated against nativeIntl.PluralRulesaccording to the active locale, mirroring Polyglot's own bucket order per locale. - Dictionaries: You bypass the need to provide huge JSON configurations to
new Polyglot()– Intlayer handles the dictionaries dynamically and prunes them automatically.