How to integrate Tolgee with a React application?

Install the @tolgee/react package, set up the Tolgee instance with your API key, and wrap your app with TolgeeProvider. The README links to detailed documentation for framework-specific setups.

Tolgee vs i18next: which should I use for localization?

Tolgee is a full platform with management tools and in-context editing, ideal for integrated workflows. i18next is a library-focused solution better for teams wanting standalone i18n without a platform dependency.

Does Tolgee work with server-side rendering (SSR)?

Yes, Tolgee supports SSR for frameworks like Next.js and Nuxt.js, but configuration varies. Check the framework-specific packages in the README for guidance on SSR implementations.

Can I use Tolgee offline or without internet access?

Basic translation caching is available, but full features like in-context editing and screenshot generation require connectivity to the Tolgee platform server, limiting offline usability.

How does the automated screenshot feature work in practice?

Tolgee captures screenshots when translation keys are accessed in your app, providing visual context for translators. This is handled automatically by the integration packages, as shown in the demo preview.

Is Tolgee free for commercial projects?

Yes, Tolgee is open-source under the MIT license, so it's free for commercial use. However, self-hosting the platform may involve infrastructure costs, and cloud options have tiered pricing.

Open-Awesome

ngx-tolgee

MITTypeScriptv7.3.0

JavaScript integration packages for Tolgee, an open-source localization platform with in-context translation.

Visit Website GitHub

261 stars40 forks0 contributors

What is ngx-tolgee?

Tolgee JS is a collection of JavaScript libraries that integrate the Tolgee localization platform into web applications. It provides tools for managing and editing translations directly within the app's interface, solving the problem of fragmented localization workflows. The platform helps developers deliver perfectly translated software with less manual effort.

Target Audience

Web developers and teams building multilingual JavaScript applications who need an integrated localization solution. It's particularly valuable for projects using React, Vue, Svelte, Angular, or i18next.

Value Proposition

Developers choose Tolgee JS because it offers a complete open-source alternative to commercial localization services with unique in-context editing capabilities. It eliminates context switching by allowing translations to be managed directly in the running application.

Overview

Tolgee JavaScript libraries monorepo

Use Cases

Best For

Adding in-context translation editing to React applications
Managing localization for Vue.js projects with visual context
Integrating translation workflows into Svelte applications
Building multilingual Angular applications with streamlined i18n
Teams needing an open-source alternative to Crowdin or Phrase
Projects requiring automated screenshot generation for translators

Not Ideal For

Projects needing only basic i18n functions without a full management platform
Applications with strict offline-first requirements where server connectivity is limited
Teams already deeply integrated with another localization service like Crowdin or Phrase
Static sites or minimal JavaScript applications that don't require dynamic in-context editing

Pros & Cons

Pros

In-Context Editing

Enables direct translation edits in the app UI, eliminating context switching and speeding up workflows, as emphasized in the README's key features.

Automated Screenshot Generation

Captures screenshots automatically to provide visual context for translators, improving accuracy and reducing manual effort, a unique feature highlighted in the demo.

Multi-Framework Support

Offers dedicated packages for React, Vue, Svelte, Angular, and i18next, ensuring broad compatibility across JavaScript ecosystems, as listed in the packages table.

Open-Source Transparency

Provides full source code access under the MIT license, allowing community contributions and cost savings compared to commercial alternatives, noted in the README's badges.

Cons

Platform Lock-in

Tightly integrated with the Tolgee platform; switching to another localization backend would require significant rework, limiting flexibility for teams using diverse tools.

Setup Overhead

Requires configuring the Tolgee server and framework-specific packages, which can be more complex than using lightweight i18n libraries like i18next alone.

Performance Trade-offs

In-context editing features add JavaScript overhead, potentially impacting initial load times and runtime performance, especially in resource-constrained environments.

Open Source Alternative To

ngx-tolgee is an open-source alternative to the following products:

Crowdin

Crowdin is a cloud-based localization management platform that helps teams translate software, websites, and content into multiple languages with collaboration tools.

Lokalise

Lokalise is a cloud-based localization and translation management platform that helps teams manage multilingual content for websites, mobile apps, and other digital products.

Phrase

Frequently Asked Questions

Related Projects

ngx-translate

The internationalization (i18n) library for Angular

Stars4,659

Forks590

Last commit2 days ago

transloco

🚀 😍 The internationalization (i18n) library for Angular

Stars2,283

Forks227

Last commit9 days ago

angular-l10n

Angular library to translate texts, dates and numbers

Stars374

Forks57

Last commit1 year ago

ng-extract-i18n-merge

Extract and merge i18n xliff translation files for angular projects.

Stars225

Forks28

Last commit3 days ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub