@tolgee/ngx NPM

Tolgee is an open-source alternative to Crowdin, Phrase, or Lokalise with its very own revolutionary integrations.

@tolgee/ngx version

typescript licence

Become part of the family. Join slack channel

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 📖.

Quick links

Tolgee for Angular docs
Tolgee JS SDK docs
Tolgee Website
- Product (Learn more about the great features)
Tolgee platform 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?

Because it saves a lot of time, you would spend on localization tasks without it. Because 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: 1. Clone the repository 1. Install the packages in the repository root

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

@tolgee/web tslib

@everything-registry/sub-chunk-925 @zalastax/nolb-_tol

5.25.1-prerelease.d38486d9.0

2 days ago

5.26.0

2 days ago

5.25.1-prerelease.d1c80a58.0

3 days ago

10 days ago

21 days ago

24 days ago

28 days ago

29 days ago

30 days ago

5.22.1-prerelease.4299f3f0.0

1 month ago

5.23.1-prerelease.88c01ea6.0

1 month ago

5.22.1-prerelease.b7e76156.0

1 month ago

5.23.0

1 month ago

5.22.1-prerelease.c21a4b30.0

1 month ago

5.22.1-prerelease.aa2f05c1.0

1 month ago

5.22.1-prerelease.d00c62d8.0

1 month ago

5.22.0

2 months ago

5.21.0

2 months ago

5.20.4-prerelease.afe383ff.0

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

5.19.7-prerelease.d6de9cd8.0

2 months ago

5.19.6

3 months ago

5.19.5

3 months ago

5.19.4

3 months ago

5.19.1-prerelease.e55c6636.0

4 months ago

5.19.3

4 months ago

5.19.3-prerelease.a08fc0b3.0

4 months ago

5.19.2

4 months ago

5.19.1

4 months ago

5.19.1-prerelease.e51a5792.0

4 months ago

5.19.0

5 months ago

5.18.0

5 months ago

5.17.0

5 months ago

5.11.1-prerelease.cb4bc75b.0

9 months ago

5.15.0

6 months ago

5.10.2-prerelease.4c2923b2.0

10 months ago

5.14.1-prerelease.a2c80516.0

6 months ago

5.10.2-prerelease.3fbb14b1.0

10 months ago

6 months ago

6 months ago

6 months ago

6 months ago

5.10.2-prerelease.4bd654a9.0

10 months ago

5.12.1-prerelease.6feb0c2e.0

8 months ago

5.9.2-prerelease.41828ff8.0

10 months ago

5.15.1-prerelease.f75e0f30.0

6 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

5.11.5-prerelease.c74f049c.0

8 months ago

5.14.1-prerelease.bcf10e02.0

6 months ago

5.10.2-prerelease.6c57bc94.0

10 months ago

5.10.2

10 months ago

5.10.1

10 months ago

5.10.0

10 months ago

5.9.2-prerelease.ce0c7097.0

10 months ago

10 months ago

10 months ago

10 months ago

8 months ago

8 months ago

8 months ago

8 months ago

9 months ago

9 months ago

5.11.5-prerelease.963d09c5.0

8 months ago

5.10.2-prerelease.466db753.0

10 months ago

5.12.0

8 months ago

5.13.3-prerelease.5f76277d.0

7 months ago

5.13.3

7 months ago

5.11.1-prerelease.74c6272d.0

9 months ago

5.13.2

7 months ago

5.13.1

7 months ago

5.13.0

7 months ago

5.16.1-prerelease.3be7ae26.0

6 months ago

5.9.3-prerelease.c6fa65f4.0

10 months ago

5.14.0

6 months ago

5.10.2-prerelease.efacb842.0

10 months ago

5.13.2-prerelease.0f38c926.0

7 months ago

5.10.2-prerelease.2a0213ec.0

10 months ago

5.12.1-prerelease.56c14f27.0

8 months ago

5.16.1-prerelease.d12444aa.0

6 months ago

5.11.6-prerelease.a415c070.0

8 months ago

5.11.1-prerelease.ebb7c0c6.0

9 months ago

5.9.0

11 months ago

5.8.8-prerelease.aa20b554.0

11 months ago

5.9.0-prerelease.333e0d35.0

12 months ago

5.8.6

12 months ago

5.8.5

12 months ago

5.8.4

12 months ago

5.8.4-prerelease.f5f66c17.0

12 months ago

5.8.8-prerelease.130cde89.0

11 months ago

5.9.0-prerelease.fffd4303.0

11 months ago

5.8.5-prerelease.dc1d5e4d.0

12 months ago

5.8.3

1 year ago

5.8.2

1 year ago

5.4.4-prerelease.9b022cf1.0

1 year ago

5.7.0-prerelease.5c23979f.0

1 year ago

5.6.1-prerelease.998593cd.0

1 year ago

5.8.1

1 year ago

5.8.0

1 year ago

5.4.4

1 year ago

5.6.0-prerelease.b5ab209e.0

1 year ago

5.5.2-prerelease.7efd46da.0

1 year ago

5.7.0-prerelease.fa761114.0

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

5.4.4-prerelease.d720afd4.0

1 year ago

5.6.0

1 year ago

5.8.1-prerelease.16fc4f78.0

1 year ago

5.7.0-prerelease.134377fa.0

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

5.4.2-prerelease.95fe706c.0

1 year ago

5.4.2

1 year ago

5.4.3-prerelease.9ea3f1fa.0

1 year ago

5.4.2-rc.2f5c8d8f.0

1 year ago

5.3.2-rc.7c739ee7.0

1 year ago

5.4.2-prerelease.8d022440.0

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

3.3.0-prerelease-a220912.0

2 years ago

3.3.0-rc.4b434d2.0

2 years ago

3.3.0-rc.0

2 years ago

3.2.0

2 years ago

3.3.0-prerelease-7dd4060.0

2 years ago

3.3.0-prerelease-e8f9afe6a3a656fda722c8e9a5857ce2554a82d5.0

2 years ago

3.3.0-prerelease-07e7034.0

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

3 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago