インストール

コアパッケージは、フレームワークやランタイムを問わず、どの TypeScript プロジェクトでも動作します。Next.js、React、Astro などのフレームワークを使っている場合は、コアの上に対応するアダプターを追加できます。

Core

npm install @better-translate/core

ほとんどのケースではこれだけで十分です。Next.js、Astro、React、Bun、Node.js、スクリプト、API、その他あらゆる TypeScript 環境で動作します。

Adapters

アダプターは、コアにフレームワーク固有のヘルパーを追加する拡張機能です。たとえば、ロケール対応ルーティング、React のコンテキストとフック、リクエスト単位のヘルパーなどです。コアを置き換えるのではなく、機能を拡張します。

利用できるアダプターはこちらです：

CLI

CLI は、ロケールファイル管理の手作業を減らすための任意の開発ツールです。

CLI には主に 2 つの役割があります：

• Extract — コード内の { bt: true } が付いた文字列を検出し、自動生成されたキー付きでソースロケールファイルに追加し、その場で呼び出しを書き換えます
• Generate — ソースロケールファイルを読み込み、AI モデルを使って他の各ロケール向けの翻訳版を生成します

npm install -D @better-translate/cli

gateway ベースの構成なら、@better-translate/cli だけで十分です。better-translate.config.ts で Ollama のようなダイレクトモデルプロバイダーを import する場合は、npm install -D ollama-ai-provider-v2 のように該当するプロバイダーパッケージも追加でインストールしてください。

npx bt extract や npx bt generate を実行する前に、better-translate.config.ts を作成してください。その後は、ローカルの Ollama モデルを含む任意の AI SDK プロバイダーモデルで CLI を利用できます。

要件

• Node.js 18+ または Bun 1.0+
• TypeScript 5.x 推奨

次のステップ