Release Type: Bug Fix Release
Status: ✅ Production Ready
Upgrade: Highly Recommended for all v4.1.0 users
🐛 Critical Fixes
Panel Issues (All Fixed ✅)
- Config Entry Not Found Error
- Issue: Panel showed "Error: Could not find config entry" when trying to save lessons
- Fix: Enhanced _getConfigEntry() with multiple fallback detection methods
- Impact: Panel can now find config entries in all installation scenarios
- Code: Added fallback to entity attributes if config_entries array not available
- Icons Not Displaying
- Issue: All icons showed as empty squares throughout panel
- Fix: Improved MDI loading with error handlers and forced re-render
- Impact: All icons now display correctly (buttons, lessons, modals)
- Code: Added setTimeout() re-render and error logging
- Modal Backgrounds Transparent
- Issue: Modal backgrounds were transparent/unclear, hard to read content
- Fix: Added explicit fallback colors with dark mode support
- Impact: Modals now have solid, readable backgrounds in all themes
- CSS: background: var(--card-background-color, #ffffff) with dark mode fallback
- Template Loading Not Working
- Issue: Clicking template buttons did nothing
- Fix: Better error handling and immediate render after application
- Impact: Templates now apply successfully with confirmation
- Code: Removed delayed render, added success logging
Card Issues (All Fixed ✅)
- Logo Not Displaying
- Issue: Card headers showed empty space or fallback icon instead of logo
- Fix: Updated logo path from /local/community/ to /hacsfiles/
- Impact: Logos now load correctly in all three cards
- Files: Logo files copied to www/ folder for proper serving
- Cards Not Found in Dashboard
- Issue: Cards didn't appear in "Add Card" picker
- Fix: Created comprehensive CARD_SETUP.md guide
- Impact: Users can now properly install and configure cards
- Docs: Multiple installation methods documented
✨ Improvements
Error Handling
- Better error messages throughout panel
- Debug logging for config entry detection
- Console warnings instead of silent failures
- User-friendly error alerts with actionable messages
Documentation
- NEW: CARD_SETUP.md - Complete card installation guide
- Troubleshooting steps for common issues
- Multiple installation methods (HACS, manual, local)
- Browser console debugging instructions
Code Quality
- All JavaScript files syntax-validated
- Proper fallback colors in CSS
- Retry logic for MDI loading
- Improved config entry detection logic