Repository navigation
Tea Timer Card v0.4.0
Release date: 2026-02-24 • Minimum Home Assistant: 2024.7.0
Highlights
- Larger in-dial countdown text for better distance readability.
- Responsive in-dial text scaling that preserves full-size typography and scales down only when the dial itself shrinks.
- Improved
Doneoverlay reliability on older Android WebView devices where finish state could be skipped or end immediately.
Install / Update
- Review the release checklist to confirm quality gates and release sign-off for this build.
- Install via HACS (custom repository) or download the assets attached to the
Tea Timer Card v0.4.0 release:
tea-timer-card.js,tea-timer-card.<hash>.js, optionaltea-timer-card.<hash>.js.map, andchecksums.txt. - Verify SHA-256 checksums before copying files into
<config>/www/for manual installs. - Ensure your Lovelace resource points at
/local/tea-timer-card.js; the stable loader imports the
fingerprinted bundle packaged with this release.
Notable behavior updates
- The dial handle is now hidden in
Done/finished state. - Finished-state fallback logic now considers monotonic and wall-clock projections, plus stale-baseline inference paths, to maintain the configured finished overlay duration on throttled WebViews.
- In-dial typography remains large at full-size dial dimensions and scales proportionally when the dial contracts on narrow cards.
Compatibility
- Minimum Home Assistant core: 2024.7.0.
- Existing v0.3.x YAML remains compatible; no breaking configuration changes.
Known limitations
- Home Assistant cores without native
timer.pausestill require the optionalinput_text.<entity>_paused_remaining
helper to expose pause/resume controls. - Browser resource cache refresh may still be required after updating bundled assets.
Troubleshooting & docs
- Review Getting Started for installation and first-run checks.
- See State & actions for current interaction semantics.
- Refer to Touch UX audit for scenario evidence and rationale behind layout and interaction behavior.
- Use Automate on
timer.finishedfor automation patterns and edge-case notes.
Feedback
- File bugs or regression reports at the issue tracker.
- For release-specific feedback, include screenshots, viewport width, platform/browser, and whether Home Assistant is running in kiosk mode.