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


## cli

- [<T> Wrapping Behavior](https://generaltranslation.com/en/docs/cli/reference/wrapping.mdx): Specific behavior of how the CLI tool wraps the `<T>` component
- [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
- [React Setup](https://generaltranslation.com/en/docs/cli/setup.mdx): Integrates gt-next or gt-react with your project.
- [Scan](https://generaltranslation.com/en/docs/cli/scan.mdx): Scans your project for translatable content
- [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.

## platform

- [AI Tools](https://generaltranslation.com/en/docs/platform/ai-tools.mdx): General Translation support for AI Tools including llms.txt and MCP server
- [API Keys](https://generaltranslation.com/en/docs/platform/apikeys.mdx): How to use API keys with General Translation
- [Automatic Translation](https://generaltranslation.com/en/docs/platform/features/files.mdx): Automatically translate your project files with General Translation.
- [Custom Roles](https://generaltranslation.com/en/docs/platform/roles.mdx): Custom roles on the General Translation platform
- [Examples](https://generaltranslation.com/en/docs/platform/examples.mdx): Example projects using General Translation
- [FAQs](https://generaltranslation.com/en/docs/platform/faqs.mdx): undefined
- [Hot Reload](https://generaltranslation.com/en/docs/platform/features/hot-reload.mdx): Hot reload your translations in development with General Translation.
- [Inline Translations](https://generaltranslation.com/en/docs/platform/features/inline.mdx): Translate your content directly in your code with General Translation's in-line translation feature.
- [Locales](https://generaltranslation.com/en/docs/platform/locale-strings.mdx): Locales and Locale Strings
- [Open Source](https://generaltranslation.com/en/docs/platform/open-source.mdx): General Translation libraries are open source!
- [Pricing](https://generaltranslation.com/en/docs/platform/pricing.mdx): Pricing details about the General Translation platform
- [Project Context](https://generaltranslation.com/en/docs/platform/context.mdx): How to add context to your project on the General Translation platform
- [Quickstart](https://generaltranslation.com/en/docs/platform.mdx): Docs for General Translation's localization libraries
- [Reviewing Translations](https://generaltranslation.com/en/docs/platform/review.mdx): How to review translations on the General Translation platform
- [Terminology](https://generaltranslation.com/en/docs/platform/terminology.mdx): A guide to the key terminology used in the General Translation libraries
- [Translation CDN](https://generaltranslation.com/en/docs/platform/cdn.mdx): How to use the CDN to serve your translations

## 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
- [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 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 Branches](https://generaltranslation.com/en/docs/next/tutorials/examples/currency-converter/branches.mdx): Let's add some plurals and conditional behavior
- [Using Variables](https://generaltranslation.com/en/docs/next/guides/variables.mdx): How to use variable components
- [Using Variables](https://generaltranslation.com/en/docs/next/tutorials/examples/currency-converter/variables.mdx): Let's add some variables to our translations
- [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.
- [getDefaultLocale()](https://generaltranslation.com/en/docs/next/api/helpers/getDefaultLocale.mdx): API Reference for the getDefaultLocale server-side method
- [getDict()](https://generaltranslation.com/en/docs/next/api/dictionary/getDict.mdx): API Reference for the getDict server-side translation function
- [getGT()](https://generaltranslation.com/en/docs/next/api/strings/getGT.mdx): API Reference for the getGT() string translation function
- [getLocale()](https://generaltranslation.com/en/docs/next/api/helpers/getLocale.mdx): API Reference for the getLocale server-side method
- [gt.config.json](https://generaltranslation.com/en/docs/next/api/config/gt-config-json.mdx): The gt.config.json file
- [loadDictionary()](https://generaltranslation.com/en/docs/next/api/config/load-dictionary.mdx): API Reference for the loadDictionary() function.
- [loadTranslations()](https://generaltranslation.com/en/docs/next/api/config/load-translations.mdx): API Reference for the loadTranslations() function.
- [tx()](https://generaltranslation.com/en/docs/next/api/strings/tx.mdx): API Reference for the tx string translation function
- [useDefaultLocale()](https://generaltranslation.com/en/docs/next/api/helpers/useDefaultLocale.mdx): API Reference for the useDefaultLocale hook
- [useDict()](https://generaltranslation.com/en/docs/next/api/dictionary/useDict.mdx): API Reference for the useDict hook
- [useGT()](https://generaltranslation.com/en/docs/next/api/strings/useGT.mdx): API Reference for the useGT() string translation function
- [useLocale()](https://generaltranslation.com/en/docs/next/api/helpers/useLocale.mdx): API Reference for the useLocale hook
- [useLocaleSelector()](https://generaltranslation.com/en/docs/next/api/helpers/useLocaleSelector.mdx): API Reference for the useLocaleSelector hook
- [useLocaleSelector](https://generaltranslation.com/en/docs/next/api/utilities/useLocaleSelector.mdx): API Reference for the useLocaleSelector hook
- [useLocale](https://generaltranslation.com/en/docs/next/api/utilities/useLocale.mdx): API Reference for the useLocale hook
- [useLocales](https://generaltranslation.com/en/docs/next/api/utilities/useLocales.mdx): API Reference for the useLocales hook
- [useSetLocale()](https://generaltranslation.com/en/docs/next/api/helpers/useSetLocale.mdx): API Reference for the useSetLocale hook
- [useSetLocale](https://generaltranslation.com/en/docs/next/api/utilities/useSetLocale.mdx): API Reference for the useSetLocale hook
- [withGTConfig()](https://generaltranslation.com/en/docs/next/api/config/withGTConfig.mdx): API Reference for the withGTConfig(), formerly initGT()

## react

- [<Branch>](https://generaltranslation.com/en/docs/react/api/components/branch.mdx): API Reference for the <Branch> component
- [<Currency>](https://generaltranslation.com/en/docs/react/api/components/currency.mdx): API Reference for the <Currency> component
- [<DateTime>](https://generaltranslation.com/en/docs/react/api/components/datetime.mdx): API Reference for the <DateTime> component
- [<GTProvider>](https://generaltranslation.com/en/docs/react/api/components/gtprovider.mdx): API Reference for the <GTProvider> component
- [<LocaleSelector>](https://generaltranslation.com/en/docs/react/api/components/localeSelector.mdx): API Reference for the <LocaleSelector> component
- [<Num>](https://generaltranslation.com/en/docs/react/api/components/num.mdx): API Reference for the <Num> component
- [<Plural>](https://generaltranslation.com/en/docs/react/api/components/plural.mdx): API Reference for the <Plural> component
- [<T>](https://generaltranslation.com/en/docs/react/api/components/t.mdx): API Reference for the <T> component
- [<Var>](https://generaltranslation.com/en/docs/react/api/components/var.mdx): API Reference for the <Var> component
- [Changing Languages](https://generaltranslation.com/en/docs/react/guides/languages.mdx): How to change the language of your React app
- [Deploying to Production](https://generaltranslation.com/en/docs/react/tutorials/quickdeploy.mdx): How to deploy your React app with GT.
- [Dictionaries](https://generaltranslation.com/en/docs/react/guides/dictionaries.mdx): How to use dictionaries
- [DictionaryTranslationOptions](https://generaltranslation.com/en/docs/react/api/types/DictionaryTranslationOptions.mdx): API Reference for the DictionaryTranslationOptions type
- [InlineTranslationOptions](https://generaltranslation.com/en/docs/react/api/types/InlineTranslationOptions.mdx): API Reference for the InlineTranslationOptions type
- [Local Translations](https://generaltranslation.com/en/docs/react/guides/local-tx.mdx): How to set up local translations for your React app
- [Migrating](https://generaltranslation.com/en/docs/react/guides/migration.mdx): Learn how to migrate a project to gt-react
- [Overview](https://generaltranslation.com/en/docs/react/introduction.mdx): Overview of General Translation's React SDK
- [Production vs Development](https://generaltranslation.com/en/docs/react/concepts/environments.mdx): Differences between production and development environments
- [Quickstart](https://generaltranslation.com/en/docs/react.mdx): Easily internationalize your React App with gt-react
- [Quickstart](https://generaltranslation.com/en/docs/react/tutorials/quickstart.mdx): Easily internationalize your React App with gt-react
- [Standalone i18n](https://generaltranslation.com/en/docs/react/concepts/stand-alone.mdx): How to use gt-react as a standalone i18n library
- [T Component](https://generaltranslation.com/en/docs/react/concepts/t-component.mdx): Behavior of the T component
- [The CLI Tool](https://generaltranslation.com/en/docs/react/reference/cli.mdx): The General Translations CLI tool
- [Translating JSX](https://generaltranslation.com/en/docs/react/guides/jsx.mdx): How to internationalize JSX components
- [Translating Strings](https://generaltranslation.com/en/docs/react/guides/strings.mdx): How to internationalize strings
- [Using Branches](https://generaltranslation.com/en/docs/react/guides/branches.mdx): How to use branch components
- [Using Variables](https://generaltranslation.com/en/docs/react/guides/variables.mdx): How to use variable components
- [gt.config.json](https://generaltranslation.com/en/docs/react/api/config/gt-config-json.mdx): The gt.config.json file
- [loadDictionary()](https://generaltranslation.com/en/docs/react/api/config/load-dictionary.mdx): API Reference for the loadDictionary() function.
- [loadTranslations()](https://generaltranslation.com/en/docs/react/api/config/load-translations.mdx): API Reference for the loadTranslations() function.
- [useDefaultLocale()](https://generaltranslation.com/en/docs/react/api/helpers/useDefaultLocale.mdx): API Reference for the useDefaultLocale hook
- [useDict()](https://generaltranslation.com/en/docs/react/api/dictionary/useDict.mdx): API Reference for the useDict hook
- [useGT()](https://generaltranslation.com/en/docs/react/api/strings/useGT.mdx): API Reference for the useGT() string translation function
- [useLocale()](https://generaltranslation.com/en/docs/react/api/helpers/useLocale.mdx): API Reference for the useLocale hook
- [useLocaleSelector()](https://generaltranslation.com/en/docs/react/api/helpers/useLocaleSelector.mdx): API Reference for the useLocaleSelector hook
- [useSetLocale()](https://generaltranslation.com/en/docs/react/api/helpers/useSetLocale.mdx): API Reference for the useSetLocale hook