Contribute Translations

How to add or update translations for Super Productivity.

Translations are JSON files in src/assets/i18n/. English (en.json) is the source and fallback: missing or empty values show the English text.

Steps

1. Add or update the source string in src/assets/i18n/en.json.
2. Do not edit another locale file directly. Those files are managed through the translation script and direct edits may be overwritten.
3. Run the app locally ([[2.11-Run-the-Development-Server]]) and check the UI.
4. Follow docs/i18n-script-usage.md if the locale files need to be propagated or a translation work-in-progress file needs to be extracted and merged.
5. Submit a pull request.

Format and Conventions

• Keep the existing nested JSON structure and SCREAMING_SNAKE_CASE keys.
• Prefer short, clear text (UI space is limited).
• Edit en.json directly; use the script workflow for every other locale.

Translation Tooling

For finding missing keys and keeping files in sync, use the script described in the repo:

docs/i18n-script-usage.md (and tools/add-missing-i18n-variables.js).

Full contributor notes: docs/TRANSLATING.md.

Related

• [[2.11-Run-the-Development-Server]]