v2.1.0

Chartdeck now speaks your language. The card and its whole visual editor follow the language in your Home Assistant profile, with German, Spanish, French, Dutch and Portuguese available alongside English. Each language is its own small file that only loads for people using it, so the card is no bigger for anyone else. Nothing about your existing cards needs changing.

Added

• The card and the visual editor read in German, Spanish, French, Dutch or Portuguese. Every label, option, help text, chart message and screen-reader description is translated: 766 strings per language. Chartdeck picks the language from your Home Assistant profile (Profile → Language), the same setting the rest of Home Assistant uses, so there is nothing to configure on the card. A regional setting such as Português (Brasil) uses the Portuguese file. Any language Chartdeck does not have yet stays in English. (#114)
• Each language loads only when someone needs it. English is built into chartdeck-card.js. Every other language is a file of its own beside it, named like chartdeck-card.de-aHFDhWpe.js, and is fetched once, as the dashboard opens. On a slow connection a card can show English for a moment before switching over by itself; the editor does the same. The part after the language code changes whenever that translation changes, so a browser holding an old copy never mixes an old translation with a new card. (#114)
• Source maps ship with every file. Each .js file in the release has a matching .js.map. Browsers only fetch them when the developer tools are open, and then an error in the console points at the line of Chartdeck's source rather than at the minified bundle, which makes bug reports much easier to act on. They are optional for a manual install. (#114)

Changed

• A release now has twelve files instead of one. chartdeck-card.js, one file per language, and a source map for each. The Marketplace (HACS before Home Assistant 2026.11) downloads all of them for you. If you install by hand, copy every .js file into <config>/www/ side by side; without the language files the card still works, in English. (#114)
• The wind rose keeps its N, E, S and W letters in every language, and the Directions choices in the editor use the same letters, so the editor always matches what the chart draws. Wind-direction sensors are still read as degrees or English compass points such as SW. (#114)
• Translations are easy to contribute. All of the English text now lives in one file, src/locales/en.json. To add a language, copy it, translate the values and add one line to src/localize.ts; to improve a translation, edit that language's file. CONTRIBUTING.md has the details, and an issue with a pasted file is just as welcome. (#114)

Upgrading

Update from the Marketplace (HACS before Home Assistant 2026.11) and refresh your browser. Your cards and their settings are unchanged.

If you installed by hand, download every .js file from this release into <config>/www/ and keep the resource pointed at /local/chartdeck-card.js. On later updates replace them all; the language files' names change from release to release, so the old ones can be deleted. Installation → By hand has the steps.

Spotted a translation that reads oddly? Open an issue with the language, the text you saw and what it should say.

Full changelog: v2.0.0...v2.1.0