# General Translation Changelog: gt-tanstack-start 0.1.0: TanStack Start 向け i18n
URL: https://generaltranslation.com/ja/blog/gt-tanstack-start_v0_1_0.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 
Authors: Ernest McCarter
Published: 2026-02-16

## 概要

`gt-tanstack-start` は、TanStack Start 向けに最適化した i18n サポートを提供する初の試みです。

> **このライブラリは実験的です。** まだごく初期の段階にあり、フィードバックを歓迎しています。TanStack で本番環境向けの翻訳が必要な場合は、現時点では `gt-react` の使用をおすすめします。

***

## 含まれるもの

* **[`initializeGT()`](/docs/react/reference/config#initialize)** — TanStack Start 用の i18n マネージャーを設定します。ルートルートファイルの先頭で一度だけ呼び出します。
* **[`GTProvider`](/docs/react/reference/components/gt-provider)** — TanStack Start 向けに調整された SSR の自動検出とロケール解決機能を備え、アプリを翻訳コンテキストでラップします。
* **[`getTranslations()`](/docs/react/tanstack-start/reference/functions/get-translations)** — ルートローダーで呼び出し、翻訳をプロバイダーに渡すための非同期関数です。
* **[`getLocale()`](/docs/react/tanstack-start/reference/functions/get-locale)** — 現在のリクエストに対して解決されたロケールを返します。
* **[`<T>`](/docs/react/reference/components/t), [`<Var>`](/docs/react/reference/components/var), [`<LocaleSelector>`](/docs/react/reference/components/locale-selector)** — `gt-react` から再エクスポートされるため、すべてを単一のパッケージからインポートできます。

***

## クイックスタート

### インストール

```bash
npm install gt-tanstack-start
```


### `gt.config.json` を設定する

```json
{
  "defaultLocale": "en",
  "locales": ["fr", "zh"],
  "files": {
    "gt": {
      "output": "src/_gt/[locale].json"
    }
  }
}
```


### 環境変数を設定する

```env
VITE_GT_PROJECT_ID=your-project-id
VITE_GT_DEV_API_KEY=your-dev-api-key
```


### 翻訳ローダーを作成する

```ts
// loadTranslations.ts
export async function loadTranslations(locale: string) {
  const translations = await import(`./src/_gt/${locale}.json`);
  return translations.default;
}
```


### ルートルートをセットアップする

```tsx
// __root.tsx
import { HeadContent, Scripts, createRootRoute } from '@tanstack/react-router';
import {
  initializeGT,
  GTProvider,
  getTranslations,
  getLocale,
} from 'gt-tanstack-start';
import gtConfig from '../../gt.config.json';
import { loadTranslations } from '../../loadTranslations';

initializeGT({
  ...gtConfig,
  projectId: import.meta.env.VITE_GT_PROJECT_ID,
  devApiKey: import.meta.env.VITE_GT_DEV_API_KEY,
  loadTranslations,
});

export const Route = createRootRoute({
  loader: async () => ({
    translations: await getTranslations(),
    locale: getLocale(),
  }),
  shellComponent: RootDocument,
});

function RootDocument({ children }: { children: React.ReactNode }) {
  const { translations, locale } = Route.useLoaderData();
  return (
    <html lang={locale}>
      <head>
        <HeadContent />
      </head>
      <body>
        <GTProvider translations={translations}>
          {children}
        </GTProvider>
        <Scripts />
      </body>
    </html>
  );
}
```


### コンテンツを翻訳する

```tsx
import { T } from 'gt-tanstack-start';

export default function Page() {
  return (
    <T>
      <p>This gets translated automatically.</p>
    </T>
  );
}
```

***


## 今後について

現在は v0.1.0 です。基盤はできていますが、まだ作るべきものはたくさんあります。
今後のリリースで追加予定の機能として、SSG やロケールルーティングがあります。

試してみたい方は、ぜひフィードバックをお寄せください。
[Discord](https://discord.gg/SjQwPjZaGa) にぜひお越しください。あるいは、[GitHub](https://github.com/generaltranslation/gt/issues) で issue を作成してください。

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.