How translations reach the app
- Developers write interface strings in English. Extraction updates the source catalogs at
apps/web/locales/en-US.poandapps/mobile/locales/en-US.po. - Contributors fill and review the target
.pocatalogs. Native extraction also copies matching web translations into empty native entries; existing native translations stay intact. - A pull request carries the reviewed catalogs and any changed PDF translation files. The repository no longer has an automatic Crowdin synchronization workflow: changes on Crowdin need a maintainer to import them before they reach the app.
- Merged translations ship with a subsequent release or compatible mobile update. A Crowdin suggestion or a merged catalog change alone does not mean the deployed app has updated.
Read the glossary first
Most of the interface is made of short, standalone labels likeBoard, Resume, or Check. Without a sentence around them, it’s easy to pick the wrong meaning. For example, Resume is always the document, never the verb “to resume”.
The glossary explains what each recurring term means in Reactive Resume, lists the wrong senses that earlier translations used, and names the terms that stay in English: the product name, technology names such as PDF, DOCX, JSON, API, and MCP, AI provider names, and template names such as Azurill and Pikachu. Read the entry for a term before you translate it.
Suggest translations on Crowdin
The Reactive Resume project on Crowdin remains linked from the repository. Before working there, coordinate with a maintainer about importing your changes: the former automatic upload/download workflow is no longer present. For a contribution that can be reviewed directly in the repository, use Updating catalogs in a checkout.1
Create a Crowdin account
Sign up at crowdin.com with your email or an existing account such as GitHub or Google. Crowdin’s guide for translators explains the basics.
2
Join the project
Open the Reactive Resume project and select Join.
3
Choose your language
Select your language on the project dashboard to see how much is already translated.
4
Translate strings
Open the file to start the Crowdin editor. The English source is on one side and your translation on the other. Use translation memory and machine suggestions as a starting point, and vote for existing translations you agree with. Crowdin saves your work as you go.
Translation guidelines
Keep placeholders unchanged
Words in curly braces are filled in by the app. Keep them exactly as they are, but move them wherever your grammar needs them. For example:{0} often come with a note in Crowdin, like placeholder {0}: application.role, that tells you what the value is.
Keep numbered tags around the same words
Tags such as<0> and </0> mark text that gets a link or emphasis. Keep each pair, and wrap the words that carry the same meaning in your language. For example:
Translate every plural form
Some strings change with a number. They use this pattern:# where the number goes, and don’t translate the keywords plural, one, and other. Crowdin shows the plural categories your language needs.
Be consistent
- Choose a formal or informal tone based on what’s normal for software in your language, and use it everywhere. Buttons and short labels avoid addressing the reader at all where your language allows: German uses the infinitive (“Lebenslauf vorbereiten”, not “Bereiten Sie …” or “Schreibe …”), Russian the perfective imperative or infinitive (“Добавить”).
- Where your language normally calls this document a CV, use CV.
- Reuse the same word for a term throughout. The glossary lists the terms that matter most.
Request a new language
First check the configured locales inapps/web/lingui.config.ts and packages/utils/src/locale.ts. If your language isn’t listed:
- Open a new issue on GitHub.
- Title it “Add [language name] translation”.
- Include the language name and its locale code, such as
ja-JPfor Japanese.
zu-ZA is reserved for the generated pseudo-locale used in testing; it is not a Zulu translation catalog.
Updating catalogs in a checkout
This section is for developers working in the repository. After you add or change user-facing strings with Lingui macros, extract the catalogs from the repository root:apps/web/locales/*.po, then apps/mobile/locales/*.po, seeds empty native messages from matching web translations, and regenerates the PDF translations. Extract before you build or run a production build: production bundles drop the English source text, so a message missing from the catalogs shows its raw message ID. CI runs pnpm lingui:check and fails when either app’s catalogs differ from what extraction would write.
Fill the empty active translations in the affected target catalogs and review any changed wording. If you update web translations after native extraction, run pnpm --filter mobile exec node scripts/seed-locales.mjs again to copy them into matching empty native entries. It does not replace existing native translations, so review those separately when wording needs to change.
Check that both catalogs contain translations before fallback:
<0>…</0>. It also lists changed translations for review and counts new untranslated and removed messages. Pass --base <ref> to compare with a branch other than origin/main. CI runs the same check on pull requests that change catalogs.
Then regenerate the PDF translations:
packages/pdf/src/section-title-catalog.json: default section titles for PDFs.packages/schema/src/resume/present-labels.json: the translated word for “Present” in date ranges.
pnpm check and pnpm build also regenerate them. Commit the generated files together with the catalog changes. Edit the .po files, never the JSON; a test in tooling/locales fails when the two drift apart.
Update English source catalogs by extracting messages from code, rather than editing the extracted text by hand. Target catalogs can be edited and reviewed in the repository. Include both the web and native catalog changes where the same user-facing wording appears; do not replace unrelated translations.
To add a new locale, a maintainer adds its code to locales in apps/web/lingui.config.ts, to localeSchema in packages/utils/src/locale.ts, and to localeMap in apps/web/src/libs/locale.ts, then extracts both apps. The native configuration reads its locale list from localeSchema.
Related pages
- Changing appearance and language: switch the app’s language.
- Development setup: run Reactive Resume locally.
- Crowdin translator docs: how the Crowdin editor works.