[](https://tolgee.io)
Tolgee is an open-source alternative to Crowdin, Phrase, or Lokalise
 
[](https://github.com/tolgee/tolgee-js)
[](https://github.com/tolgee/tolgee-platform)
[](https://github.com/tolgee/tolgee-platform/discussions)
[](https://hub.docker.com/repository/docker/tolgee/tolgee)
[](https://docs.tolgee.io/)
[](https://join.slack.com/t/tolgeecommunity/shared_invite/zt-2zp55d175-_agXTfKKVbf1BYXlKlmwbA)
[](https://dev.to/tolgee_i18n)
[](https://www.youtube.com/@tolgee)
[](https://www.linkedin.com/company/tolgee/)
[](https://x.com/Tolgee_i18n)
# What is Tolgee for React?
React integration library of Tolgee. This package makes it super simple to add i18n to your React app!
For more information about using Tolgee with React, visit the [docs 📖](https://tolgee.io/integrations/react).
Localize (translate) your CRA, Next.js, or other React projects to multiple languages with Tolgee. Integration of Tolgee is extremely simple! 🇯🇵 🇰🇷 🇩🇪 🇨🇳 🇺🇸 🇫🇷 🇪🇸 🇮🇹 🇷🇺 🇬🇧
## Quick links
- [Tolgee for React docs](https://tolgee.io/js-sdk/5.0.0-alpha.1/integrations/react/installation)
- [Tolgee JS SDK docs](https://tolgee.io/js-sdk)
- [Tolgee Website](https://tolgee.io)
- Product (Learn more about the great features)
- [Dev tools](https://tolgee.io/features/dev-tools)
- [Translation assistance](https://tolgee.io/features/translation-assistance)
- [Collaboration](https://tolgee.io/features/collaboration)
- [Tolgee platform docs](https://tolgee.io/platform)
## Installation
```
npm install @tolgee/react
```
Then use the library in your app:
```typescript jsx
import { TolgeeProvider, ReactPlugin, FormatSimple } from "@tolgee/react";
const tolgee = Tolgee()
.use(ReactPlugin())
.use(FormatSimple())
.init({
language: 'en',
apiUrl: process.env.REACT_APP_TOLGEE_API_URL,
apiKey: process.env.REACT_APP_TOLGEE_API_KEY
});
```
## Usage
To translate texts using Tolgee React integration, you can use `T` component or `useTranslate` hook.
### T component
```typescript jsx
import { T } from "@tolgee/react";
...
translation_key
```
or
```typescript jsx
Default value
```
### useTranslate hook
```javascript
import { useTranslate } from "@tolgee/react";
...
const { t } = useTranslate();
...
t("key_to_translate")
```
## Prerequisites
1. You have some React-based project
2. You have generated an API key from [Tolgee Cloud](https://app.tolgee.io) 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 🔥
Read more on the [Tolgee website](https://tolgee.io)
## Development
We welcome your PRs.
To develop the package locally:
1. Clone [the repository](https://github.com/tolgee/tolgee-js)
1. Install the packages in the repository root
```
pnpm install
```
1. Run the development script
```
pnpm develop:react
```
This runs the development suite of this monorepo for the `react` 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/react` directory.
### End-to-end (e2e) testing
To run the e2e tests, simply execute
```
pnpm run e2e run react
```
To open and play with e2e tests, run:
```
pnpm run e2e open react
```
## Contributors
