# General Translation — React, Next.js, and React Native SDKs (gt-next, gt-react, gt-react-native)

> Exhaustive documentation index for React, Next.js, and React Native SDKs (gt-next, gt-react, gt-react-native).

Documentation links point to the plain-markdown view of each page; removing the `.mdx` extension gives the HTML page.

## Pages

- [Next.js Pages Router Quickstart](https://generaltranslation.com/en-US/docs/react/nextjs-pages-router-quickstart.mdx): Add multiple languages to a Next.js Pages Router app with General Translation in under 10 minutes.
- [Next.js App Router Quickstart](https://generaltranslation.com/en-US/docs/react/nextjs-quickstart.mdx): Add multiple languages to a Next.js App Router app with General Translation in under 10 minutes.
- [Overview](https://generaltranslation.com/en-US/docs/react/overview.mdx): Learn which React library and quickstart fit your framework.
- [React Native Quickstart](https://generaltranslation.com/en-US/docs/react/react-native-quickstart.mdx): Add General Translation to a React Native app with gt-react-native, covering both Expo and the bare React Native CLI.
- [React Quickstart](https://generaltranslation.com/en-US/docs/react/react-quickstart.mdx): Add multiple languages to a server-rendered React app with General Translation in under 10 minutes.
- [React SPA Quickstart](https://generaltranslation.com/en-US/docs/react/react-spa-quickstart.mdx): Add multiple languages to a single-page React application.
- [TanStack Start Quickstart](https://generaltranslation.com/en-US/docs/react/tanstack-start-quickstart.mdx): Add General Translation to a TanStack Start app with gt-tanstack-start, and translate your first content.
- [Configuring General Translation](https://generaltranslation.com/en-US/docs/react/guides/configuring.mdx): How to initialize General Translation, configure credentials, and deliver translations with `<GTProvider>`.
- [Developing with SPA translations](https://generaltranslation.com/en-US/docs/react/guides/developing-spa-translations.mdx): How to preview General Translation translations while developing a single-page React app.
- [Formatting numbers and dates](https://generaltranslation.com/en-US/docs/react/guides/formatting-variables.mdx): How to format numbers, currency, dates, relative time, and dynamic values for each locale in React.
- [Handling plurals and branches](https://generaltranslation.com/en-US/docs/react/guides/handling-plurals-and-branches.mdx): How to handle React pluralization and conditional translated content with `<Plural>` and `<Branch>`.
- [Linting your code](https://generaltranslation.com/en-US/docs/react/guides/linting-your-code.mdx): How to catch common internationalization mistakes with the General Translation ESLint plugin.
- [Managing locales](https://generaltranslation.com/en-US/docs/react/guides/managing-locales.mdx): How to configure supported locales, build a React language switcher, and read or change the active locale.
- [Migrating i18n libraries](https://generaltranslation.com/en-US/docs/react/guides/migrating-i18n-libraries.mdx): How to move an existing React internationalization setup to General Translation without discarding current translations.
- [Storing translations locally](https://generaltranslation.com/en-US/docs/react/guides/storing-translations.mdx): How to bundle General Translation translations locally instead of loading them from the CDN.
- [Translating JSX](https://generaltranslation.com/en-US/docs/react/guides/translating-jsx.mdx): How to translate JSX in place with the General Translation `<T>` component.
- [Translating strings](https://generaltranslation.com/en-US/docs/react/guides/translating-strings.mdx): How to translate standalone strings such as labels and placeholders with the General Translation useGT hook.
- [Translating with dictionaries](https://generaltranslation.com/en-US/docs/react/guides/translating-with-dictionaries.mdx): How to translate strings from a central dictionary with the General Translation useTranslations hook.
- [Configuration](https://generaltranslation.com/en-US/docs/react/reference/config.mdx): Configure the React ecosystem with the shared gt.config.json file and runtime initialization. Reference for gt.config.json.
- [Lint rules](https://generaltranslation.com/en-US/docs/react/reference/lint-rules.mdx): Keep translatable content static and correct with React Core linter rules. Reference for React Core linter rules.
- [App Router middleware](https://generaltranslation.com/en-US/docs/react/nextjs/app-router-middleware.mdx): How to configure General Translation locale routing for the Next.js App Router.
- [App Router static site generation](https://generaltranslation.com/en-US/docs/react/nextjs/app-router-static-site-generation.mdx): How to pre-render localized Next.js App Router pages with General Translation.
- [Using Cache Components](https://generaltranslation.com/en-US/docs/react/nextjs/cache-components.mdx): How to use Next.js Cache Components with locale-safe request functions and locally stored translations.
- [Configuration](https://generaltranslation.com/en-US/docs/react/nextjs/config.mdx): Configure General Translation in a Next.js app with the withGTConfig plugin from gt-next/config, its options, and local versus CDN translations. API reference for withGTConfig.
- [Next.js](https://generaltranslation.com/en-US/docs/react/nextjs.mdx): Explore the Next.js-specific features of General Translation, including server components, server functions, the config plugin, locale routing, request locale registration, and localized navigation.
- [Localized navigation](https://generaltranslation.com/en-US/docs/react/nextjs/link.mdx): Navigate directly to localized App Router routes with General Translation's locale-aware Link component. API reference for Link.
- [Managing locale alias SEO](https://generaltranslation.com/en-US/docs/react/nextjs/locale-alias-seo.mdx): How to use custom locale aliases in Next.js URLs while publishing canonical language metadata for search engines.
- [Pages Router locale routing](https://generaltranslation.com/en-US/docs/react/nextjs/pages-router-middleware.mdx): How to configure Next.js internationalized routing with General Translation in the Pages Router.
- [Pages Router static site generation](https://generaltranslation.com/en-US/docs/react/nextjs/pages-router-static-site-generation.mdx): How to pre-render localized Next.js Pages Router pages with General Translation.
- [Registering request locales](https://generaltranslation.com/en-US/docs/react/nextjs/registering-request-locales.mdx): How to register a locale for Next.js App Router route handlers and generated metadata images with General Translation.
- [Server components](https://generaltranslation.com/en-US/docs/react/nextjs/server-components.mdx): Translate content in React Server Components with General Translation, and understand how gt-next behaves in server versus client components.
- [React Native](https://generaltranslation.com/en-US/docs/react/react-native.mdx): Explore the React Native-specific setup for General Translation, including initialization, the provider, polyfills, and troubleshooting.
- [Plugin](https://generaltranslation.com/en-US/docs/react/react-native/plugin.mdx): Reference for the General Translation gt-react-native Babel plugin, which injects the Intl polyfills React Native needs. API reference for the gt-react-native plugin.
- [Set up React Native](https://generaltranslation.com/en-US/docs/react/react-native/setup.mdx): Initialize General Translation in a React Native app, add the provider, and load translations, for both Expo and the bare React Native CLI.
- [Troubleshooting React Native](https://generaltranslation.com/en-US/docs/react/react-native/troubleshooting.mdx): How to diagnose native module, polyfill, locale, translation file, and development issues in a React Native app.
- [TanStack Start](https://generaltranslation.com/en-US/docs/react/tanstack-start.mdx): Explore the TanStack Start-specific setup, locale routing, and isomorphic runtime APIs for General Translation.
- [Set up TanStack Start](https://generaltranslation.com/en-US/docs/react/tanstack-start/setup.mdx): Register General Translation request middleware, initialize a TanStack Start app, resolve the locale, and hydrate the provider.
- [Using server functions](https://generaltranslation.com/en-US/docs/react/tanstack-start/using-server-functions.mdx): How to translate strings and read request state with General Translation in TanStack Start server functions.
- [Configuring a Bazel SPA](https://generaltranslation.com/en-US/docs/react/guides/spa/configuring-bazel-spa.mdx): How to configure gt-react in a Bazel-powered single-page React application.
- [Configuring an esbuild SPA](https://generaltranslation.com/en-US/docs/react/guides/spa/configuring-esbuild-spa.mdx): How to configure gt-react in an esbuild-powered single-page React application.
- [Configuring a Rolldown SPA](https://generaltranslation.com/en-US/docs/react/guides/spa/configuring-rolldown-spa.mdx): How to configure gt-react in a Rolldown-powered single-page React application.
- [Configuring a Rollup SPA](https://generaltranslation.com/en-US/docs/react/guides/spa/configuring-rollup-spa.mdx): How to configure gt-react in a Rollup-powered single-page React application.
- [Configuring a Vite SPA](https://generaltranslation.com/en-US/docs/react/guides/spa/configuring-vite-spa.mdx): How to configure gt-react in a Vite-powered single-page React application.
- [Configuring a webpack SPA](https://generaltranslation.com/en-US/docs/react/guides/spa/configuring-webpack-spa.mdx): How to configure gt-react in a webpack-powered single-page React application.
- [Internationalizing a React SPA](https://generaltranslation.com/en-US/docs/react/guides/spa/internationalizing-react-spa.mdx): How to mark JSX and strings for translation in a configured React SPA.
- [`<Branch>`](https://generaltranslation.com/en-US/docs/react/reference/components/branch.mdx): Render content conditionally based on a value. API reference for the `<Branch>` component.
- [`<Currency>`](https://generaltranslation.com/en-US/docs/react/reference/components/currency.mdx): Format a currency amount for the active locale. API reference for the `<Currency>` component.
- [`<DateTime>`](https://generaltranslation.com/en-US/docs/react/reference/components/datetime.mdx): Format a date and time for the active locale. API reference for the `<DateTime>` component.
- [`<Derive>`](https://generaltranslation.com/en-US/docs/react/reference/components/derive.mdx): Mark finite content variants for extraction inside a translation. API reference for the `<Derive>` component.
- [`<GTProvider>`](https://generaltranslation.com/en-US/docs/react/reference/components/gt-provider.mdx): Provide translation and locale context to a React component tree. API reference for the `<GTProvider>` component.
- [`<LocaleSelector>`](https://generaltranslation.com/en-US/docs/react/reference/components/locale-selector.mdx): Render a dropdown for switching the active locale. API reference for the `<LocaleSelector>` component.
- [`<Num>`](https://generaltranslation.com/en-US/docs/react/reference/components/num.mdx): Format a number for the active locale. API reference for the `<Num>` component.
- [`<Plural>`](https://generaltranslation.com/en-US/docs/react/reference/components/plural.mdx): Render count-based content using the active locale's plural rules. API reference for the `<Plural>` component.
- [`<RegionSelector>`](https://generaltranslation.com/en-US/docs/react/reference/components/region-selector.mdx): Render a dropdown for switching the active region. API reference for the `<RegionSelector>` component.
- [`<RelativeTime>`](https://generaltranslation.com/en-US/docs/react/reference/components/relative-time.mdx): Format localized relative time, such as 2 hours ago. API reference for the `<RelativeTime>` component.
- [`<T>`](https://generaltranslation.com/en-US/docs/react/reference/components/t.mdx): Translate JSX children in place. API reference for the `<T>` component.
- [`<Var>`](https://generaltranslation.com/en-US/docs/react/reference/components/var.mdx): Render a dynamic value inside a translation without translating it. API reference for the `<Var>` component.
- [declareVar](https://generaltranslation.com/en-US/docs/react/reference/functions/declare-var.mdx): Mark a non-translatable variable inside derived content. API reference for declareVar.
- [decodeVars](https://generaltranslation.com/en-US/docs/react/reference/functions/decode-vars.mdx): Expand variables encoded by declareVar back into their values. API reference for decodeVars.
- [derive](https://generaltranslation.com/en-US/docs/react/reference/functions/derive.mdx): Mark finite content variants inside a string translation for extraction. API reference for derive.
- [getTranslationsSnapshot](https://generaltranslation.com/en-US/docs/react/reference/functions/get-translations-snapshot.mdx): Load a locale's translations for `<GTProvider>`. API reference for getTranslationsSnapshot.
- [loadDictionary](https://generaltranslation.com/en-US/docs/react/reference/functions/load-dictionary.mdx): Load your own dictionary translations as a standalone i18n library. API reference for loadDictionary.
- [loadTranslations](https://generaltranslation.com/en-US/docs/react/reference/functions/load-translations.mdx): Customize how translations are loaded in production. API reference for loadTranslations.
- [msg](https://generaltranslation.com/en-US/docs/react/reference/functions/msg.mdx): Register and encode a string for translation at module scope. API reference for msg.
- [t](https://generaltranslation.com/en-US/docs/react/reference/functions/t-function.mdx): Translate strings synchronously at module scope. API reference for t.
- [DictionaryTranslationOptions](https://generaltranslation.com/en-US/docs/react/reference/types/dictionary-translation-options.mdx): Options for passing variables to dictionary entries. API reference for DictionaryTranslationOptions.
- [InlineTranslationOptions](https://generaltranslation.com/en-US/docs/react/reference/types/inline-translation-options.mdx): Options for passing variables and metadata to inline string translations. API reference for InlineTranslationOptions.
- [useDefaultLocale](https://generaltranslation.com/en-US/docs/react/reference/hooks/use-default-locale.mdx): Read the source (default) locale. API reference for useDefaultLocale.
- [useGT](https://generaltranslation.com/en-US/docs/react/reference/hooks/use-gt.mdx): Get a function to translate strings inline. API reference for useGT.
- [useLocaleDirection](https://generaltranslation.com/en-US/docs/react/reference/hooks/use-locale-direction.mdx): Read the text direction for a locale. API reference for useLocaleDirection.
- [useLocaleProperties](https://generaltranslation.com/en-US/docs/react/reference/hooks/use-locale-properties.mdx): Read display metadata for a locale. API reference for useLocaleProperties.
- [useLocaleSelector](https://generaltranslation.com/en-US/docs/react/reference/hooks/use-locale-selector.mdx): Build a custom locale switcher. API reference for useLocaleSelector.
- [useLocale](https://generaltranslation.com/en-US/docs/react/reference/hooks/use-locale.mdx): Read the active locale. API reference for useLocale.
- [useLocales](https://generaltranslation.com/en-US/docs/react/reference/hooks/use-locales.mdx): List the supported locales. API reference for useLocales.
- [useMessages](https://generaltranslation.com/en-US/docs/react/reference/hooks/use-messages.mdx): Resolve strings registered with msg into the active locale. API reference for useMessages.
- [useRegionSelector](https://generaltranslation.com/en-US/docs/react/reference/hooks/use-region-selector.mdx): Build a custom region switcher. API reference for useRegionSelector.
- [useRegion](https://generaltranslation.com/en-US/docs/react/reference/hooks/use-region.mdx): Read the active region. API reference for useRegion.
- [useSetLocale](https://generaltranslation.com/en-US/docs/react/reference/hooks/use-set-locale.mdx): Change the active locale. API reference for useSetLocale.
- [useSetRegion](https://generaltranslation.com/en-US/docs/react/reference/hooks/use-set-region.mdx): Change the active region. API reference for useSetRegion.
- [useTranslations](https://generaltranslation.com/en-US/docs/react/reference/hooks/use-translations.mdx): Look up string translations from a dictionary by id. API reference for useTranslations.
- [`<Tx>`](https://generaltranslation.com/en-US/docs/react/nextjs/reference/components/tx.mdx): Translate request-time JSX in Next.js App Router server components. API reference for the `<Tx>` component.
- [createNextMiddleware](https://generaltranslation.com/en-US/docs/react/nextjs/reference/functions/create-next-middleware.mdx): Add locale routing and detection to a Next.js app with General Translation. API reference for createNextMiddleware.
- [getGT](https://generaltranslation.com/en-US/docs/react/nextjs/reference/functions/get-gt.mdx): Translate standalone strings in asynchronous Next.js App Router components with General Translation. API reference for getGT.
- [getLocaleDirection](https://generaltranslation.com/en-US/docs/react/nextjs/reference/functions/get-locale-direction.mdx): Read the text direction for a Next.js App Router locale with General Translation. API reference for getLocaleDirection.
- [getLocale](https://generaltranslation.com/en-US/docs/react/nextjs/reference/functions/get-locale.mdx): Read the current Next.js App Router request locale with General Translation. API reference for getLocale.
- [getMessages](https://generaltranslation.com/en-US/docs/react/nextjs/reference/functions/get-messages.mdx): Resolve encoded messages in asynchronous Next.js App Router components with General Translation. API reference for getMessages.
- [getRegion](https://generaltranslation.com/en-US/docs/react/nextjs/reference/functions/get-region.mdx): Read the current Next.js App Router request region with General Translation. API reference for getRegion.
- [getTranslations](https://generaltranslation.com/en-US/docs/react/nextjs/reference/functions/get-translations.mdx): Read dictionary translations in asynchronous Next.js App Router components with General Translation. API reference for getTranslations.
- [isLocaleSupported](https://generaltranslation.com/en-US/docs/react/nextjs/reference/functions/is-locale-supported.mdx): Check whether a route value resolves to a configured gt-next locale. API reference for isLocaleSupported.
- [registerLocale](https://generaltranslation.com/en-US/docs/react/nextjs/reference/functions/register-locale.mdx): Register a locale for Next.js App Router server code with General Translation. API reference for registerLocale.
- [resolveCanonicalLocale](https://generaltranslation.com/en-US/docs/react/nextjs/reference/functions/resolve-canonical-locale.mdx): Resolve a configured locale alias in Next.js App Router server code with General Translation. API reference for resolveCanonicalLocale.
- [tx](https://generaltranslation.com/en-US/docs/react/nextjs/reference/functions/tx.mdx): Translate request-time strings in Next.js App Router server code with General Translation. API reference for tx.
- [getEnableI18n](https://generaltranslation.com/en-US/docs/react/tanstack-start/reference/functions/get-enable-i18n.mdx): Read whether internationalization is enabled in the TanStack Start runtime. API reference for getEnableI18n.
- [getGT](https://generaltranslation.com/en-US/docs/react/tanstack-start/reference/functions/get-gt.mdx): Translate standalone strings in the TanStack Start runtime with General Translation. API reference for getGT.
- [getLocale](https://generaltranslation.com/en-US/docs/react/tanstack-start/reference/functions/get-locale.mdx): Read the current TanStack Start runtime locale with General Translation. API reference for getLocale.
- [getMessages](https://generaltranslation.com/en-US/docs/react/tanstack-start/reference/functions/get-messages.mdx): Resolve registered messages in the TanStack Start runtime with General Translation. API reference for getMessages.
- [getTranslations](https://generaltranslation.com/en-US/docs/react/tanstack-start/reference/functions/get-translations.mdx): Read dictionary translations in the TanStack Start runtime with General Translation. API reference for getTranslations.
- [gtMiddleware](https://generaltranslation.com/en-US/docs/react/tanstack-start/reference/functions/gt-middleware.mdx): Create request-scoped locale state for TanStack Start server functions. API reference for gtMiddleware.