Migrate from NGX-Translate to Intlayer

Migrating your Angular application from ngx-translate to Intlayer is easy with the compat adapter, allowing you to bypass the need to rewrite all your templates.

What to do

Begin by running:

npx intlayer init --interactive

This sets up the intlayer.config.ts. Replace your TranslateModule.forRoot() setups and import aliases appropriately to point to @intlayer/ngx-translate.

What it does under the hood

ngx-translate uses TranslateService (instant, get, stream) alongside the {{ 'KEY' | translate:params }} pipe and the [translate] directive.

Under the hood:

• Services: TranslateService wraps getIntlayer and a locale observable, providing exactly the same methods.
• Pipes & Directives: Re-implemented to resolve against Intlayer dictionaries directly.
• Loaders: TranslateHttpLoader setups are converted to warning stubs because Intlayer inherently resolves and bundles your dictionaries at build time (or through standard dynamic imports), completely eliminating the need for HTTP loaders.

To understand where these libraries come from, read the history of JavaScript i18n.