General Translation

# General Translation

> General Translation is an entire internationalization (i18n) stack that allows you to ship multilingual apps quickly and easily. It includes open-source developer libraries for React and Next.js, an AI translation service, and a complete infrastructure package for serving translation content.

This documentation covers everything from getting started to advanced features, APIs, and best practices for working with General Translation. The documentation is organized into key sections covering different aspects of the General Translation ecosystem.

General Translation provides a seamless end-to-end i18n solution that integrates naturally into your development workflow. With minimal configuration, it handles the entire pipeline from content extraction to translation delivery. Developers can write code naturally without cluttering their codebase with complex i18n logic.

The core components include:

- **gt-react**: Core React library with hooks and components for translations and formatting. Supports in-line translations without the need for a dictionary.

- **gt-next**: Extends gt-react with a Next.js integration, providing SSR support, dynamic content translation, and more.

- **gtx-cli**: Command-line tool for managing translations and content. Connects to the General Translation API to automatically translate projects with AI. The CLI tool also supports translating different file formats, including JSON, MDX, and Markdown.


## changelog

- [Changelog for 7/7/25](https://generaltranslation.com/en/docs/changelog/7-7-25.mdx): Breaking changes in GT libraries as of July 7th, 2025

## cli

- [Auth](https://generaltranslation.com/en/docs/cli/auth.mdx): Authenticate your project with General Translation
- [Automatic Translation](https://generaltranslation.com/en/docs/cli.mdx): How to automatically translate your project using the General Translation CLI tool
- [Configuration](https://generaltranslation.com/en/docs/cli/reference/config.mdx): Config docs for the gt.config.json file
- [Configure](https://generaltranslation.com/en/docs/cli/configure.mdx): Configure your project's GT settings
- [Generate Source Template](https://generaltranslation.com/en/docs/cli/generate.mdx): How to generate a source template for your project
- [JSON](https://generaltranslation.com/en/docs/cli/formats/json.mdx): How to automatically translate JSON files with General Translation
- [Markdown](https://generaltranslation.com/en/docs/cli/formats/mdx.mdx): How to use General Translation to set up automatic translation for your project's Markdown files
- [Setup Wizard](https://generaltranslation.com/en/docs/cli/init.mdx): Run the GT setup wizard
- [Stage](https://generaltranslation.com/en/docs/cli/stage.mdx): How to stage your translations for review
- [Translate](https://generaltranslation.com/en/docs/cli/translate.mdx): How to translate your project
- [TypeScript](https://generaltranslation.com/en/docs/cli/formats/ts.mdx): How to automatically translate TypeScript and JavaScript files with General Translation
- [Usage Guide](https://generaltranslation.com/en/docs/cli/reference/usage.mdx): Usage guide for the GT command line tool
- [gt-next & gt-react](https://generaltranslation.com/en/docs/cli/formats/gt.mdx): Automatically translate your gt-next or gt-react project
- [i18next](https://generaltranslation.com/en/docs/cli/formats/i18next-quickstart.mdx): Automatically translate your i18next project (<5 min)
- [next-intl](https://generaltranslation.com/en/docs/cli/formats/next-intl-quickstart.mdx): Automatically translate your next-intl project in less than 5 minutes

## core

- [Core](https://generaltranslation.com/en/docs/core.mdx): Docs for General Translation's core libraries

## key-concepts

- [Dynamic Content](https://generaltranslation.com/en/docs/key-concepts/dynamic-content.mdx): A brief overview of working with Dynamic Content in GT.
- [On-Demand vs Proactive Translation](https://generaltranslation.com/en/docs/key-concepts/tx-loading.mdx): What is the difference between performing translation on-demand and translating ahead of time?
- [Private Information](https://generaltranslation.com/en/docs/key-concepts/private-information.mdx): A brief overview of working with Private Information in GT.

## locadex

- [Auto-merge Pull Requests](https://generaltranslation.com/en/docs/locadex/auto-merge.mdx): Configure Locadex to automatically merge pull requests
- [Locadex for Mintlify](https://generaltranslation.com/en/docs/locadex/mintlify.mdx): Automate translation for your Mintlify docs
- [Locadex for Next.js App Router](https://generaltranslation.com/en/docs/locadex/next.mdx): Automate translation for your Next.js app
- [Locadex — AI i18n engineer](https://generaltranslation.com/en/docs/locadex.mdx): Get started with Locadex, an automated internationalization engineer
- [Monorepo Support](https://generaltranslation.com/en/docs/locadex/monorepos.mdx): How to use Locadex on a Next.js app within a monorepo

## next

- [<Branch>](https://generaltranslation.com/en/docs/next/api/components/branch.mdx): API Reference for the <Branch> component
- [<Currency>](https://generaltranslation.com/en/docs/next/api/components/currency.mdx): API Reference for the <Currency> component
- [<DateTime>](https://generaltranslation.com/en/docs/next/api/components/datetime.mdx): API Reference for the <DateTime> component
- [<GTProvider>](https://generaltranslation.com/en/docs/next/api/components/gtprovider.mdx): API Reference for the <GTProvider> component
- [<LocaleSelector>](https://generaltranslation.com/en/docs/next/api/components/localeSelector.mdx): API Reference for the <LocaleSelector> component
- [<Num>](https://generaltranslation.com/en/docs/next/api/components/num.mdx): API Reference for the <Num> component
- [<Plural>](https://generaltranslation.com/en/docs/next/api/components/plural.mdx): API Reference for the <Plural> component
- [<T>](https://generaltranslation.com/en/docs/next/api/components/t.mdx): API Reference for the <T> component
- [<Tx>](https://generaltranslation.com/en/docs/next/api/components/tx.mdx): API Reference for the <Tx> component
- [<Var>](https://generaltranslation.com/en/docs/next/api/components/var.mdx): API Reference for the <Var> component
- [Add gt-next](https://generaltranslation.com/en/docs/next/tutorials/examples/currency-converter/preptx.mdx): Let's get your project ready for translation!
- [Changing Languages](https://generaltranslation.com/en/docs/next/guides/languages.mdx): How to change the language of your Next.js app
- [Compiler](https://generaltranslation.com/en/docs/next/concepts/compiler.mdx): gt-next's rust-based SWC plugin.
- [Deploy to Production](https://generaltranslation.com/en/docs/next/tutorials/quickdeploy.mdx): Let's deploy your Next.js app with GT.
- [Dictionaries](https://generaltranslation.com/en/docs/next/guides/dictionaries.mdx): How to use dictionaries
- [DictionaryTranslationOptions](https://generaltranslation.com/en/docs/next/api/types/DictionaryTranslationOptions.mdx): API Reference for the DictionaryTranslationOptions type
- [InlineTranslationOptions](https://generaltranslation.com/en/docs/next/api/types/InlineTranslationOptions.mdx): API Reference for the InlineTranslationOptions type
- [Local Translations](https://generaltranslation.com/en/docs/next/guides/local-tx.mdx): How to set up local translations for your Next.js app
- [Middleware](https://generaltranslation.com/en/docs/next/guides/middleware.mdx): A step by step guide on adding internationalization (i18n) middleware routing to your application
- [Migrating](https://generaltranslation.com/en/docs/next/guides/migration.mdx): Learn how to migrate a project to gt-next
- [Next.js Quickstart](https://generaltranslation.com/en/docs/next.mdx): Easily internationalize your Next.js App with gt-next
- [Next.js Quickstart](https://generaltranslation.com/en/docs/next/tutorials/quickstart.mdx): Easily internationalize your Next.js App with gt-next
- [Overview](https://generaltranslation.com/en/docs/next/introduction.mdx): Overview of General Translation's Next.js SDK
- [Production vs Development](https://generaltranslation.com/en/docs/next/concepts/environments.mdx): Differences between production and development environments
- [Right-to-Left Support](https://generaltranslation.com/en/docs/next/guides/rtl.mdx): A step by step guide on adding Right-to-Left (RTL) support to your application
- [RuntimeTranslationOptions](https://generaltranslation.com/en/docs/next/api/types/RuntimeTranslationOptions.mdx): API Reference for the RuntimeTranslationOptions type
- [Setup](https://generaltranslation.com/en/docs/next/tutorials/dictionary/setup.mdx): Set up a tutorial project
- [Setup](https://generaltranslation.com/en/docs/next/tutorials/examples/currency-converter/setup.mdx): Set up a tutorial project
- [Speedrun Next.js](https://generaltranslation.com/en/docs/next/tutorials/examples/next-speedrun.mdx): Let's speedrun creating a new app and internationalizing it with GT.
- [Standalone i18n](https://generaltranslation.com/en/docs/next/concepts/stand-alone.mdx): How to use gt-next as a standalone i18n library
- [Static Site Generation](https://generaltranslation.com/en/docs/next/guides/ssg.mdx): How to support static site generation for your i18n app
- [T Component](https://generaltranslation.com/en/docs/next/concepts/t-component.mdx): Behavior of the T component
- [Translating Dynamic Content](https://generaltranslation.com/en/docs/next/guides/dynamic-content.mdx): How to translate dynamic content in Next.js server components
- [Translating JSX](https://generaltranslation.com/en/docs/next/guides/jsx.mdx): How to internationalize JSX components
- [Translating Shared Strings](https://generaltranslation.com/en/docs/next/guides/shared-strings.mdx): How to internationalize shared strings
- [Translating Strings](https://generaltranslation.com/en/docs/next/guides/strings.mdx): How to internationalize strings
- [Translating Strings](https://generaltranslation.com/en/docs/next/tutorials/translating-strings.mdx): How to translate strings
- [Using Branches](https://generaltranslation.com/en/docs/next/guides/branches.mdx): How to use branch components
- [Using Variables](https://generaltranslation.com/en/docs/next/guides/variables.mdx): How to use variable components
- [Using the <T> Component](https://generaltranslation.com/en/docs/next/tutorials/examples/currency-converter/t.mdx): Let's do some translation!
- [createNextMiddleware()](https://generaltranslation.com/en/docs/next/api/middleware/createNextMiddleware.mdx): API Reference for the createNextMiddleware() method.