@tolgee/core

Tolgee JS Core
The Core of Tolgee JS integrations

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

What is Tolgee JS Core?

It's the core library of Tolgee JS integrations containing the platform-agnostic parts of the Tolgee JS. For more information about Tolgee JS integrations, visit the docs.

Quick links

• Tolgee JS SDK docs
• Tolgee Website
  • Product (Learn more about the great features)
    • Dev tools
    • Translation assistance
    • Collaboration
• Integrations (Learn how to integrate Tolgee with your favorite technology)
  • React
  • Angular
  • Vue
  • Svelte
  • Next.js
  • More...
• Tolgee platform docs

You should not use this package directly for usage in the web browser

If you use Tolgee on the web, use @tolgee/web package, which extends this package with web-related functionality.

This package is platform-agnostic, so it contains only the most general functionality.

Installation

npm install @tolgee/core

Usage

First, create a Tolgee instance and run it.

import { TolgeeCore } from "@tolgee/core";

const tg = TolgeeCore()
  .use(...)
  .init(...)

tg.run();

To learn more, check the docs.

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 🔥

Read more on the Tolgee website

Development

We welcome your PRs.

To develop the package locally:

• Clone the repository
• Install the packages in the repository root

pnpm install

• Run web or any integration development script

pnpm develop:react

or

pnpm develop:web

This runs the development suite of this monorepo for the specific 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/core directory.

End-to-end (e2e) testing

Each integration is end-to-end tested via cypress. The tests are defined in /e2e/cypress/e2e directory.

To run the e2e tests, run

pnpm run e2e run <integration>

E.g.

pnpm run e2e run web

To open and play with e2e tests, run:

pnpm run e2e open <integration>

Contributors