Contributing a translation

The editor UI ships in ten languages. Adding an eleventh is a single JSON file in the monorepo.

How locales work

packages/i18n/en.json is the source of truth. Every other locale mirrors its shape; a null value falls back to the English string at runtime, and a missing key fails CI. Locales publish as named exports and per-locale subpaths of @docx-editor.dev/i18n.

Add a language

git clone https://github.com/eigenpal/docx-editor && cd docx-editor
bun install

bun run i18n:new <code>   # scaffolds packages/i18n/<code>.json with nulls
# fill in the strings, then
bun run i18n:status       # shows remaining nulls per locale
bun run i18n:validate     # CI runs this; missing keys fail

Use a BCP 47 code (pl, pt-BR, zh-CN). Open a PR with the filled JSON. Partial translations are fine: anything left null renders in English, so a locale can land incomplete and improve over time.

Fixing an existing locale

Edit the string in packages/i18n/<code>.json, run bun run i18n:validate, and open a PR. No code changes needed.

Next steps

• i18n package: wiring locales into the editor
• i18n API reference: every locale export
• Open a PR