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

title: TanStack Start
description: General Translation の TanStack Start 固有のセットアップ、ロケールルーティング、および同型ランタイム API について説明します。

---

`gt-tanstack-start` を使うと、TanStack Start アプリで General Translation を利用できます。共有の `gt-react` コンポーネント、hooks、関数を再エクスポートし、同型ランタイムヘルパーを追加し、メインのエントリを通じて リクエストミドルウェア を提供します。

使い始めたばかりなら、まず [TanStack Start Quickstart](/docs/react/tanstack-start-quickstart) を参照してください。共有の [Guides](/docs/react/guides/configuring) と [リファレンス](/docs/react/reference/config) では、フレームワークをまたいで共通する内容を扱っています。このページでは、TanStack Start 専用のセットアップを説明します。

<Callout type="warn">
  **警告:** `gt-tanstack-start` は実験的機能であり、破壊的変更が入る可能性があります。現時点では、Production での使用は推奨されていません。
</Callout>

## TanStack Start 固有の要素 [#overview]

* **リクエストミドルウェア。** サーバー関数用のリクエストごとの状態を作成するために、`gt-tanstack-start` の [`gtMiddleware`](/docs/react/tanstack-start/reference/functions/gt-middleware) を登録します。
* **Router と root route のセットアップ。** `src/router.tsx` のモジュールスコープで [`initializeGT`](/docs/react/reference/config#initialize) を呼び出し、[`getLocale`](/docs/react/tanstack-start/reference/functions/get-locale) でロケールを判定し、root route の `loader` で翻訳スナップショットを読み込み、その両方を [`<GTProvider>`](/docs/react/reference/components/gt-provider) に渡します。詳しくは[セットアップ](/docs/react/tanstack-start/setup)を参照してください。
* **ロケールルーティング。** 任意の `/{-$locale}` ルートセグメントまたは URL リライトを使用して、プレフィックスなしとロケールのプレフィックス付きの両方の URL を受け入れるように TanStack Router を設定します。その後、`localeRouting` を `true` に設定して、デフォルトロケールにはプレフィックスを付けないまま、デフォルト以外のロケールを pathname に保持します。詳しくは[セットアップ](/docs/react/tanstack-start/setup#locale-routing)を参照してください。
* **同型ランタイム関数。** [`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)、[`getTranslations`](/docs/react/tanstack-start/reference/functions/get-translations) を使って、ランタイム状態を読み取り、翻訳できます。サーバーでは、[`gtMiddleware`](/docs/react/tanstack-start/reference/functions/gt-middleware) のリクエストスコープ内でこれらを呼び出します。

## ページ [#pages]

| ページ                                                                    | 説明                                                              |
| ---------------------------------------------------------------------- | --------------------------------------------------------------- |
| [セットアップ](/docs/react/tanstack-start/setup)                             | リクエストミドルウェアを登録し、General Translation を初期化して、provider をハイドレートします。 |
| [サーバー関数の使用](/docs/react/tanstack-start/using-server-functions)         | TanStack Start のサーバー関数で文字列を翻訳し、リクエストの状態を読み取ります。                 |
| [リファレンス](/docs/react/tanstack-start/reference/functions/gt-middleware) | `gt-tanstack-start` Runtime API を参照します。                         |