ai-i18n-tools

🌐

UI strings

Extract t() calls from JS, TS, and Astro. Generate flat per-locale JSON for i18next or static SSG lookup.

📄

Documents

Translate Markdown, MDX, and Astro pages for VitePress, Starlight, Docusaurus, Nextra, Fumadocs, and plain static sites.

📦

JSON bundles

Nested locale JSON when UI copy lives outside source t() calls — theme labels, catalogs, and app overrides.

🔄

Smart caching

Shared SQLite cache across every pipeline. Only new or changed segments are sent to the model on reruns.

🔌

Provider-agnostic

Built-in presets for major LLM APIs plus custom OpenAI-compatible endpoints. Override the active provider with -P.

⚡

One sync command

Run extract, translate-ui, translate-svg, translate-docs, and translate-json in the right order from a single config.

Quick install

The published package is ESM-only. Node.js >=22.16.0 required.

bash

pnpm add ai-i18n-tools
# Set API key for your active provider — see preset table (default init: openrouter)
export OPENROUTER_API_KEY=sk-or-v1-your-key-here
ai-i18n-tools init [-P <provider>]
ai-i18n-tools sync

Which pipeline should I use?

Your content	Command
Source code uses `t()`	UI strings — `extract` / `translate-ui`
Localized pages or docs sites	Documents — `translate-docs`
Standalone nested JSON locale files	JSON — `translate-json`

Your content

Command

Source code uses t()

UI strings — extract / translate-ui

Localized pages or docs sites

Documents — translate-docs

Standalone nested JSON locale files

JSON — translate-json

SVG illustrations use a separate translate-svg path — not docs[].contentPaths. See What is ai-i18n-tools? for a full comparison.

Explore the documentation

Guide — translation modes, installation, quick start, and framework integrations

Integrations — VitePress, Nextra, Fumadocs, Docusaurus, and Astro

Providers and models — presets, fallback chains, and -P overrides

CLI reference — every command, flag, and workflow

Configuration — full ai-i18n-tools.config.json schema

Examples — nine runnable demo projects with npx degit

Architecture — internals, programmatic API, and extension points

Integrating the package into your own project? Start with AI Agent Context. The repository README is a short GitHub/npm landing page that links here for detail.

ai-i18n-toolsTranslate apps & docs with any LLM