| name | translations |
| description | Frontend translation workflow using Lingui - extracting, adding, and compiling translations for all supported languages |
Frontend Translation Workflow (Lingui)
IMPORTANT: Always update translations as you develop features. When adding new translatable strings, immediately add translations for all supported languages.
Core Commands
cd frontend
yarn messages:extract --clean
yarn messages:compile
cd scripts && ./list_untranslated_strings.sh
Process
- Extract:
yarn messages:extract --clean
- Check: Look at the output table for missing translation counts
- Add translations: Update the
.po files for each language
- Verify: Run extract again to confirm 0 missing
- Compile:
yarn messages:compile
Adding Translations
Add entries to each locale's .po file in frontend/src/locales/:
#: src/path/to/component.tsx:123
msgid "Your English String"
msgstr "Translated String"
Supported Languages
| Code | Language |
|---|
| en | English (source - no translation needed) |
| de | Deutsch |
| es | Espanol |
| fr | Francais |
| pt | Portugues |
| pt-br | Portugues do Brasil |
| it | Italiano |
| nl | Nederlands |
| zh-cn | Simplified Chinese |
| zh-hk | Traditional Chinese (HK) |
| vi | Tieng Viet |
| ru | Russian (currently untranslated) |
Troubleshooting
- Counts seem wrong: Use
--clean flag to remove obsolete entries
- Translation not appearing: Run
yarn messages:compile after adding
- Syntax errors: Check for proper escaping of quotes in
.po files