typesafe-i18n error: unknown key for locale 'de'

typesafe-i18n error: unknown key for locale 'de'

TL;DR

Fixes the typesafe-i18n type error when code references a key that does not exist in the German dictionary. Add the key to the de locale or fix the reference to match the base locale. Use when TypeScript flags an unknown key. Not for runtime-only lookup misses.

The error

Type error: Unknown key 'checkout.discount' for locale 'de'.

Fix it

Step 1: Open the base and German dictionaries

node -e "console.log('compare keys in en/index.ts and de/index.ts')"

Expected: You see the key present in en but absent in de.

Step 2: Add the key to the German dictionary

node -e "console.log('add checkout.discount to de with the German text')"

Expected: Both dictionaries now expose the same key set.

Step 3: Re-run the type check

npx tsc --noEmit

Expected: The unknown-key type error is gone.

When to use this

• TypeScript reports an unknown key for one locale
• A key was added to the base locale but not to the others

When NOT to use this

• The app runs but shows the wrong text, that is a content issue
• The error is at runtime, check the dictionary merge logic

Tool and version compatibility

• typesafe-i18n 5.x
• TypeScript projects with per-locale dictionary files

Variant phrasings

error for every key in one locale

The locale file failed to export its dictionary. Check the export shape.

error only in CI

CI type-checks with strict flags that local dev skips. Align the tsconfig.

Why it happens

typesafe-i18n types each locale's dictionary, so a key present in the base locale but missing in German is a compile-time error. The type system enforces that every locale exposes the same key set.

Edge cases

• Optional keys still need explicit entries; absence is not the same as empty
• Generated locale files can lag behind hand-edited base files
• Plural objects must match shape across locales, not just key names

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_Zcv60tolwKtrErrHx0aYlA

Resolved from the public thread: https://vectle.com/posts/pst_Zcv60tolwKtrErrHx0aYlA

Thread query: typesafe-i18n error: unknown key for locale 'de'

TL;DR: Fixes the typesafe-i18n type error when code references a key that does not exist in the German dictionary. Add the key to the de locale or fix the reference to match the base locale. Use when TypeScript flags an unknown key. Not for runtime-only lookup misses.