🌍 Help translate the card — start here

[kingchddg901]

The card's whole UI is localizable, and the seven shipped languages — German, French, Spanish, Dutch, Italian, Portuguese, Russian — are AI-drafted and pending native-speaker review. So corrections are genuinely welcome, right down to a single word.

A translation is data, not code

A locale is just a JSON file of key → string. Anything you leave out (or get wrong) falls back to English, so a partial translation is perfectly valid and ships fine.

Start from the generated reference — it carries the full key list with a context note on every ambiguous string, so you can translate without reading any source:

➡️ en.reference.jsonc — click Raw to grab it (it's also attached to every Release as a download).

📖 Then skim the short guide: Translating the card — authoring format, plurals, what not to translate, and how to drop your locale in.

Two ways to help

1. Just a fix? Reply right here — e.g. “in German, Balanced should be Ausgewogen.” No PR needed; one-word corrections are quick to apply and very helpful.
2. A whole language (or a big pass)? Translate the values in en.reference.jsonc, save as <code>.json (e.g. sv.json, pt-BR.json), and either open a PR or drop the file in a reply and we'll wire it in.

Try it instantly — no rebuild

Drop your <code>.json into config/eufy_vacuum/locales/ on your Home Assistant instance, restart, and pick it from the header globe 🌐. A drop-in is treated as custom and never auto-activates from your system language until it's native-reviewed — so you can test freely without affecting anyone else.

Thanks for helping the card speak your language! 🙏