# General Translation React SDKs (gt-react, gt-next, gt-react-native): TanStack Start
URL: https://generaltranslation.com/en-US/docs/react/tanstack-start.mdx
---

title: TanStack Start
description: Explore the TanStack Start-specific setup, locale routing, and isomorphic runtime APIs for General Translation.

---

`gt-tanstack-start` brings General Translation to TanStack Start apps. It re-exports the shared `gt-react` components, hooks, and functions, adds isomorphic runtime helpers, and provides request middleware through its main entry.

If you are just getting started, follow the [TanStack Start Quickstart](/docs/react/tanstack-start-quickstart) first. The shared [Guides](/docs/react/guides/configuring) and [Reference](/docs/react/reference/config) cover everything that works the same across frameworks; the page here covers the TanStack Start-only setup.

<Callout type="warn">
  **Warning:** `gt-tanstack-start` is experimental and may have breaking changes. It is not yet recommended for production use.
</Callout>

## What is TanStack Start-specific [#overview]

- **Request middleware.** Register [`gtMiddleware`](/docs/react/tanstack-start/reference/functions/gt-middleware) from the `gt-tanstack-start/server` compatibility path in 11.1.4 to create request-local state for server functions.
- **Router and root-route setup.** Call [`initializeGT`](/docs/react/reference/config#initialize) at module scope in `src/router.tsx`, resolve the locale with [`getLocale`](/docs/react/tanstack-start/reference/functions/get-locale), load a translations snapshot in the root route loader, and pass both to [`<GTProvider>`](/docs/react/reference/components/gt-provider). See [Setup](/docs/react/tanstack-start/setup).
- **Locale routing.** Configure TanStack Router to accept both unprefixed and locale-prefixed URLs with either optional `/{-$locale}` route segments or URL rewrites. Then set `localeRouting` to `true` to keep non-default locales in the pathname while leaving the default locale unprefixed. See [Setup](/docs/react/tanstack-start/setup#locale-routing).
- **Isomorphic runtime functions.** Read runtime state and translate with [`getLocale`](/docs/react/tanstack-start/reference/functions/get-locale), [`getEnableI18n`](/docs/react/tanstack-start/reference/functions/get-enable-i18n), [`getGT`](/docs/react/tanstack-start/reference/functions/get-gt), [`getMessages`](/docs/react/tanstack-start/reference/functions/get-messages), and [`getTranslations`](/docs/react/tanstack-start/reference/functions/get-translations). On the server, call them inside the [`gtMiddleware`](/docs/react/tanstack-start/reference/functions/gt-middleware) request scope.

## Pages [#pages]

| Page | Description |
| --- | --- |
| [Setup](/docs/react/tanstack-start/setup) | Register request middleware, initialize General Translation, and hydrate the provider. |
| [Using server functions](/docs/react/tanstack-start/using-server-functions) | Translate strings and read request state in TanStack Start server functions. |
| [Reference](/docs/react/tanstack-start/reference/functions/gt-middleware) | Browse the `gt-tanstack-start` runtime API. |