1 2.18 Contribute Translations

github-actions[bot] edited this page 2026-02-20 20:14:22 +00:00

Table of Contents

• Contribute Translations
• Steps
• Format and Conventions
• Translation Tooling
• Related

Contribute Translations

How to add or update translations for Super Productivity.

Translations are JSON files in src/assets/i18n/ (e.g. de.json, fr.json). English (en.json) is the fallback: missing or empty values show the English text.

Steps

1. Open the language file in src/assets/i18n/ for your locale.
2. Edit string values only. Keep the same nested structure and SCREAMING_SNAKE_CASE keys.
3. Leave a key as "" if you want the English fallback; do not copy English text into empty strings unless you are providing a real translation.
4. Run the app locally (2.11-Run-the-Development-Server) and check the UI.
5. Submit a pull request with the changed JSON file(s).

Format and Conventions

• Nested JSON; only change the string values, not keys or structure.
• Prefer short, clear text (UI space is limited).
• Use en.json as the reference for context and key names.

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

1.00-Quickstarts

• 1.01-First-Steps
• 1.02-Configure-Data-Synchronization

2.00-How_To

Using Super-Productivity

• 2.01-Downloads and Install
• 2.02-Restore-Data-From-Backup
• 2.03-Add-Tasks
• 2.04-Manage-Subtasks
• 2.05-Manage-Scheduled-Tasks
• 2.06-Manage-Repeating-Tasks
• 2.07-Manage-Task-Integrations
• 2.08-Choose-Sync-Backend
• 2.09-Configure-Sync-Backend
• 2.19-Sync-Proton-Drive-via-rclone
• 2.13-Run-with-Docker

Contributing to Super-Productivity

• 2.18-Contribute-Translations
• 2.11-Run-the-Development-Server
• 2.16-Set-Up-Development-Environment
• 2.12-Package-the-App
• 2.14-Build-for-Android
• 2.15-Develop-a-Plugin
• 2.17-Add-a-New-Issue-Integration

3.00-Reference

• 3.01-API
• 3.02-Settings-and-Preferences
• 3.03-Keyboard-Shortcuts
• 3.04-Short-Syntax
• 3.05-Web-App-vs-Desktop
• 3.06-User-Data
• 3.07-Issue-Integration-Comparison
• 3.08-Sync-Integration-Comparison
• 3.09-Theming

4.00-Concepts

Data-and-Integrations

• 4.23-Managing-Your-Data
• 4.24-Integrations

Organizing

• 4.06-Project-View
• 4.07-Tag-View
• 4.08-Time-Estimates
• 4.09-Task-Attributes
• 4.10-Task-Notes
• 4.11-Subtasks

Planning

• 4.03-Planner-View
• 4.04-Schedule-View
• 4.12-Scheduled-Tasks
• 4.13-Repeating-Tasks
• 4.08-Time-Estimates

Doing

• 4.01-The-Today-View
• 4.02-Inbox-View
• 4.05-Board-View
• 4.14-How-Time-Is-Logged
• 4.15-Timers-and-Focus-Mode
• 4.16-Break-Reminders
• 4.17-Idle-Time
• 4.08-Time-Estimates

Reviewing

• 4.14-How-Time-Is-Logged
• 4.08-Time-Estimates
• 4.18-Reflection
• 4.19-Metrics
• 4.20-Task-Archiving
• 4.22-Quick-History
• 4.21-Worklog

If you have further questions, please refer to the discussions page.