Ship global products faster with AI-powered internationalization.
An intelligent i18n assistant that automates the tedious parts of internationalization:
- 🔍 Auto-extract translatable strings from your code
🤖 AI-translate to 100+ languages in seconds
✅ Quality checks for consistency and completeness
📊 Reports on translation coverage and health
🔄 Sync translations across multiple frameworks
🎯 Why cuihua-i18n-helper?
Traditional i18n workflow is painful:
1. ❌ Manually find all hardcoded strings
❌ Manually create translation keys
❌ Manually copy to each locale file
❌ Manually send to translators
❌ Manually track what's missing
❌ Manually clean up unused translations
cuihua-i18n-helper automates ALL of this.
🚀 Quick Start
Extract translatable strings
Tell your OpenClaw agent:
"Extract all translatable strings from src/"
The agent will:
- Find all hardcoded UI text
Generate semantic translation keys
Create locale files for your languages
Show translation coverage report
Translate to multiple languages
"Translate to Chinese, Japanese, and Spanish"
The agent will:
- Batch translate all strings
Preserve formatting and placeholders
Check translation quality
Report any issues
Check translation health
"Check for missing translations"
The agent will:
- Find missing translations
Find unused translation keys
Check for consistency issues
Generate actionable report
🎨 Features
1. Smart String Extraction 🔍
Automatically detects translatable content:
CODEBLOCK0
Supports:
- JSX/TSX (React)
Vue templates
Angular templates
Plain JavaScript strings
Template literals with variables
2. Intelligent Key Generation 🧠
Creates semantic, readable translation keys:
CODEBLOCK1
Smart features:
- Context-aware naming
Namespace organization
Collision prevention
Consistent naming conventions
3. Batch Translation 🌐
Translate to 100+ languages instantly:
Supported providers:
- ✅ DeepL (best quality)
✅ Google Translate (fast, free tier)
✅ OpenAI GPT (context-aware)
✅ Azure Translator
✅ LibreTranslate (self-hosted)
Smart translation:
- Preserves placeholders: {{count}}, INLINECODE1
Handles HTML tags: INLINECODE2
Keeps special characters: INLINECODE3
Context-aware translations
Example output:
CODEBLOCK2
4. Translation Quality Checks ✅
Automated quality assurance:
Checks:
- ✅ Missing translations
✅ Placeholder mismatches
✅ Inconsistent terminology
✅ Excessive string length
✅ Untranslated strings (still in source language)
✅ HTML tag mismatches
✅ Special character issues
Example report:
CODEBLOCK3
5. Framework Integration 🔧
Works seamlessly with popular frameworks:
React / Next.js:
CODEBLOCK4
Vue / Nuxt.js:
CODEBLOCK5
Angular:
CODEBLOCK6
Vanilla JS:
CODEBLOCK7
6. CI/CD Integration 🔄
Automate translation checks in your pipeline:
CODEBLOCK8
Pre-commit hook:
#!/bin/bash
# .git/hooks/pre-commit
echo "🔍 Checking i18n..."
openclaw agent run "Check for untranslated strings in staged files"
if [ $? -ne 0 ]; then
echo "❌ Found untranslated strings. Please add translations."
exit 1
fi
📋 Usage Examples
Example 1: New Project Setup
User: "Set up i18n for my React project with English and Chinese"
Agent:
CODEBLOCK10
Example 2: Extract from Existing Code
User: "Extract all translatable strings from src/components/"
Agent:
CODEBLOCK11
Example 3: Add New Language
User: "Add German and French translations"
Agent:
CODEBLOCK12
Example 4: Find Missing Translations
User: "Check for missing translations"
Agent:
CODEBLOCK13
Example 5: Clean Up Unused Translations
User: "Remove unused translation keys"
Agent:
CODEBLOCK14
User: "Yes"
CODEBLOCK15
Example 6: Translation Review Workflow
User: "Mark translations needing review"
Agent:
🔍 Analyzing translations for review...
⚠️ Flagged for review (8 strings):
1. user.welcome_premium
Translation seems too literal
Suggestion: Use more natural phrasing
2. error.payment_failed (zh)
Contains English words: "payment"
Suggestion: Translate to "支付"
3. button.purchase_now (de)
Too long for button (28 characters)
Suggestion: Shorten to "Jetzt kaufen"
📝 Created review.md with details
💡 Next: Share review.md with translators
⚙️ Configuration
Create .i18nrc.json in your project root:
CODEBLOCK17
🌐 Supported Languages
100+ languages including:
Popular:
- 🇨🇳 Chinese (Simplified, Traditional)
🇯🇵 Japanese
🇰🇷 Korean
🇩🇪 German
🇫🇷 French
🇪🇸 Spanish
🇮🇹 Italian
🇷🇺 Russian
🇵🇹 Portuguese
🇦🇪 Arabic
And many more: Dutch, Swedish, Danish, Polish, Turkish, Thai, Vietnamese, Indonesian, Hindi, Hebrew, Greek, Czech, Romanian, Hungarian, Finnish, Norwegian, Ukrainian, and more!
💰 Pricing
Free Tier
- ✅ Extract up to 100 strings
✅ 2 target languages
✅ Basic quality checks
✅ Google Translate only
Pro ($12/month)
- ✅ Unlimited extraction
✅ Unlimited languages
✅ All translation providers
✅ Advanced quality checks
✅ CI/CD integration
✅ Priority support
Enterprise ($99/month)
- ✅ Everything in Pro
✅ Team collaboration
✅ Translation memory
✅ Custom translation engines
✅ On-premise deployment
✅ SLA support
🔒 Privacy & Security
- ✅ Local processing - Extraction happens locally
✅ Secure API calls - Encrypted communication with translation providers
✅ No data retention - Translations not stored on our servers
✅ Self-hosted option - Use LibreTranslate for complete privacy
