translate-kit
Detect projects using translate-kit by checking for translate-kit.config.ts in the project root.
After modifying translatable strings
When you add, modify, or delete user-facing strings in JSX/TSX files, run:
npx translate-kit run
This executes the full pipeline: scan → codegen → translate.
| Step | What it does |
|---|---|
scan | Parses TSX/JSX, extracts translatable strings, generates semantic keys |
codegen | Replaces raw strings with t() calls or <T> wrappers in source code |
translate | Sends only new/modified keys to AI, merges with cached translations |
Do NOT manually edit
These files are generated and managed by translate-kit:
.translate-map.json— text-to-key mapping.translate-lock.json— translation cache hashes.translate-context.json— extracted context metadata- Locale JSON files in the configured messages directory
Useful commands
npx translate-kit run # Full pipeline
npx translate-kit run --dry-run # Preview without writing
npx translate-kit run --force # Ignore cache, re-translate everything
npx translate-kit run --locale es # Only translate a specific locale
npx translate-kit scan # Scan only
npx translate-kit translate # Translate only (incremental)