verbaly

コードにテキストを書いて、あらゆる言語でリリースしましょう。

React、Vue、Svelte、Next.js、Nuxt、SvelteKit、Astro、プレーンな HTML 向けの i18n コンパイラーと小さなランタイムです。
同期を保つキー管理ファイルは不要です。テキストからパラメーターの型が推論され、CI ゲートが翻訳の不備を防ぎます。

アイデア

ほとんどの i18n ツールでは、文ごとにキーを考え、言語ごとにファイルへ記述し、コードに合わせて手作業でファイルを同期し続ける必要があります。Verbaly はその発想を逆転させます。

// with key files: name it, write it in en.json, es.json, pt.json, keep them in sync
t('dashboard.welcome_back', { name });

// with Verbaly: write the sentence where it is used
t`Welcome back, ${name}`;

// and the compiler writes a stable key and a typed call for you
t('ESsQIvlA', { name });

リリースされるランタイムは依存関係ゼロで gzip 圧縮後 3.35 KB です。リリースごとに、このリポジトリのチェックゲート（pnpm --filter verbaly size）で測定しています。

クイックスタート

pnpm add verbaly @verbaly/vite
pnpm add -D @verbaly/compiler   # the verbaly command: init, extract, check
npx verbaly init

// vite.config.ts
import verbaly from '@verbaly/vite';

export default { plugins: [verbaly()] };

// anywhere in your app: extracted and typed on save
import { t, setLocale } from 'verbaly/app';

t`Hello ${name}`;
await setLocale('es'); // loads only the Spanish module

verbaly/app はプロジェクト独自のモジュールです。プラグインが設定をもとに、言語とカタログを組み込んで生成します。Next.js、Nuxt、SvelteKit、Astro にはそれぞれ1行で設定する方法があります。上の一覧から該当するものを選ぶか、https://verbaly-web.vercel.app/docs で完全なドキュメントをご覧ください。

Verbaly を選ぶ理由

npx verbaly-studio

Studio は localhost でプロジェクトを表示します。未対応の項目、壊れている項目、機械が生成した内容、コード内の各テキストの場所を確認できます。JSON ファイルがデータベースで、git が履歴です。保存時には verbaly check と同じ検証が実行され、ソーステキストが編集されることはありません。

比較

サイズは各ライブラリのメインエントリーを min+gzip で測定したもので、React は外部依存として扱っています。2026-10-15 に同じ方法で測定しました。

コーディングエージェント

claude mcp add verbaly -- npx -y @verbaly/mcp

MCP サーバーは、構造化出力と設定やカタログを読み取るためのリソースを備え、エージェントに一連の作業全体をツールとして提供します。機械翻訳は、人が承認するまで下書きのままです（verbaly review --approve または Studio）。意図的に、承認はツールとして提供していません。Agent Skill では、書き込み、抽出、チェック、翻訳の一連の作業を説明しています（npx degit AronSoto/verbaly/skills/verbaly .claude/skills/verbaly）。また、ドキュメントは llms.txt を公開しています。

パッケージ

すべて同じバージョン番号を共有し、各リリースは npm provenance 付きで CI から公開されます。

{
  "i18n-ally.localesPaths": ["locales"],
  "i18n-ally.keystyle": "flat",
  "i18n-ally.sourceLanguage": "en",
  "i18n-ally.displayLanguage": "en"
}

languageIds:
  - javascript
  - typescript
  - javascriptreact
  - typescriptreact
  - vue
  - svelte
  - astro
usageMatchRegex:
  - "[^\\w\\d]t\\(\\s*['\"`]({key})['\"`]"
monopoly: true

開発

pnpm install
pnpm build      # tsdown: ESM + CJS + .d.ts
pnpm test       # each package's suite
pnpm typecheck
pnpm --filter verbaly bench   # the hot path against i18next

Verbaly は 0.x であり、マイナーバージョン間でも API が変更される可能性があります。すべての変更は変更履歴に記載されています。貢献を歓迎します。CONTRIBUTING.mdをご覧ください。

フィードバック

• 問題が起きた、または予想外の動作があった場合： バグを報告してください。最小限のコードスニペットで十分です。
• 使いづらさを感じた場合： 内容をお知らせください。ロードマップは実際の利用状況に基づいています。
• 問題なく動作した場合： スターや言及があると、ほかの人にも見つけてもらいやすくなります。

スポンサー

Verbaly は MIT ライセンスで、依存関係がなく、独立して開発されています。時間の節約に役立ったなら、スポンサーになることで、1.0 に向けた取り組み（統合の拡充、リリースの迅速化、長期的なメンテナンス）を支援できます。

ライセンス

MIT © Aron Soto · @AronSoto