Introducing Socket Firewall: Free, Proactive Protection for Your Software Supply Chain.Learn More
Socket
Book a DemoInstallSign in
Socket

@tolgee/ngx

Package Overview
Dependencies
Maintainers
2
Versions
351
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@tolgee/ngx

Angular integration of Tolgee localization tool

latest
Source
npmnpm
Version
6.2.7
Version published
Weekly downloads
990
-23.02%
Maintainers
2
Weekly downloads
 
Created
Source

Tolgee for Angular
The Tolgee i18n SDK for Angular

Logo

Tolgee is an open-source alternative to Crowdin, Phrase, or Lokalise

test workflow @tolgee/ngx version typescript Types Typescript Licence GitHub Stars

GitHub Stars GitHub Discussions Docker Read the Docs Slack Dev.to YouTube LinkedIn X

What's Tolgee for Angular?

Angular integration library of Tolgee. With this package. It's super simple to add i18n to your Angular app! For more information about using Tolgee with Angular, visit the docs 📖.

Installation

npm install @tolgee/ngx

Then use the library in your app.module.ts. You have to add NgxTolgeeModule to your imports section and add factory provider for TOLGEE_INSTANCE token returning your Tolgee instance.

...
import {
  DevTools,
  NgxTolgeeModule,
  Tolgee,
  TOLGEE_INSTANCE,
  FormatSimple
} from '@tolgee/ngx';
...
@NgModule({
  declarations: [
    ...
  ],
  imports: [
    NgxTolgeeModule,
    ...
  ],
  providers: [
    {
      provide: TOLGEE_INSTANCE,
      useFactory: () => {
        return Tolgee()
          .use(DevTools())
          .use(FormatSimple())
          .init({
            language: 'en'

            // for development
            apiUrl: environment.tolgeeApiUrl,
            apiKey: environment.tolgeeApiKey,

            // for production
            staticData: {
              ...
            }
          });
      },
    },
  ],
  bootstrap: [AppComponent],
})
export class AppModule {}

Usage

Translating using pipe:

<h1>{{&#39;hello_world&#39; | translate}}</h1>

Or using t attribute

<h1 t key="providing_default_values"></h1>

Prerequisites

  • You have some Angular-based project
  • You have generated an API key from Tolgee Cloud or a self-hosted Tolgee instance.

Why to use Tolgee?

Tolgee saves a lot of time you would spend on localization tasks otherwise. It enables you to provide perfectly translated software.

Features

  • All-in-one localization solution for your JS application 🙌
  • Out-of-box in-context localization 🎉
  • Automated screenshot generation 📷
  • Translation management platform 🎈
  • Open-source 🔥

Frame 47 Read more on the Tolgee website

Development

We welcome your PRs.

To develop the package locally:

pnpm install
  • Run the development script
pnpm develop:ngx

This runs the development suite of this monorepo for the ngx integration. The changes in each dependency package are automatically built and propagated to the test application, which you can open and play within the browser.

Testing

To run Jest tests of this package, execute

npm run test

In the /packages/ngx directory.

End-to-end (e2e) testing

To run the e2e tests, simply execute

pnpm run e2e run ngx

To open and play with e2e tests, run:

pnpm run e2e open ngx

Contributors

contributors

FAQs

Package last updated on 05 Aug 2025

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts