1.4.0. Frontend Debugging & Translation Cleanup

Frontend Debugging & Translation Cleanup

This release introduces a new Frontend Debug Logging option that can be enabled from the integration's options menu. When enabled, additional diagnostic information is written to the browser console, making it easier to troubleshoot icon loading, metadata, viewBox deviations, and frontend behavior.

Highlights

• New Frontend Debug Logging toggle in integration options.
• Frontend debug state is now exposed through the integration info endpoint and automatically applied in the frontend loader.
• Improved logging with clearer reporting of configuration changes.
• Added Dutch translations.
• Migrated translation handling to a modern Home Assistant translation structure.
• General code cleanup and internal refactoring.

Upgrade Notes

After upgrading:

1. Open the integration options if you want to enable frontend debugging.
2. Reload the integration or restart Home Assistant.
3. Open your browser developer console to view frontend debug output.

No configuration changes are required for existing users.

What's Changed

• Update README.md with note for frontend debug logging by @Mariusthvdb in #12
• Update CHANGELOG.md to 1.4.0 by @Mariusthvdb in #13

Full Changelog: 1.3.1...1.4.0

fixes: #11

1.3.1

🚀 Release Notes — v1.3.1

✨ Custom Local Icons
This release improves clarity between icon discovery, validation, and rendering behavior, and enhances troubleshooting and debugging capabilities.

✨ Features
Improved separation between icon discovery (/list) and rendering pipeline
Expanded troubleshooting documentation for icon picker vs frontend rendering behavior
Added optional frontend debug mode (DEBUG = true) for SVG diagnostics
Improved logging guidance for both backend and frontend for easier debugging

🐛 Fixes
Better handling and explanation of icons that exist in /list but fail to render in the UI
Improved clarity around why complex SVGs (Inkscape / Illustrator exports) may not render correctly
Reduced confusion between “icon is listed” vs “icon is renderable”
Improved invalid icon name reporting consistency

⚠️ Breaking / Behavioral Changes
/list continues to return all discovered SVG files, regardless of render compatibility
Rendering pipeline remains best-effort and does not filter at discovery stage
SVG rendering only uses extracted data; advanced SVG features (filters, masks, transforms, groups) are not fully supported
Console logging is explicitly debug/diagnostic only and does not represent final render outcome

🧠 Notes
Icon picker reflects filesystem discovery, not guaranteed renderability
Debug mode exposes additional SVG parsing insights without affecting runtime behavior
Rendering and discovery are intentionally decoupled for performance and stability

What's Changed

• Update CHANGELOG for version 1.2.0 by @Mariusthvdb in #9
• Fix HACS (Recommended) install button — add missing category param by @nordstad in #10

New Contributors

• @nordstad made their first contribution in #10

Full Changelog: 1.2.0...1.3.1

1.2.0

What's Changed

• Refactor icon scanning and improve async handling by @Mariusthvdb in #6
• Enhance SVG icon handling and validation by @Mariusthvdb in #7
• Revise README for improved structure and details by @Mariusthvdb in #8

fixes: #5
Full Changelog: 1.1.0...1.2.0

Refactor icon system to synchronous-first rendering

Full Changelog: 1.0.1...1.1.0

🎨 Custom Local Icons – Major stability and rendering update
This release introduces a significant improvement to the icon rendering model, making custom SVG icons behave consistently with Home Assistant’s native Material Design Icons (MDI) system.

✨ Improvements
⚡ MDI-like synchronous rendering model
Icons now resolve deterministically during render time, matching the behavior of built-in HA icons
Eliminates first-load inconsistencies in dashboards and UI frameworks

🔄 Background icon hydration
Icons are preloaded and cached in the background after initial discovery
Improves perceived performance while maintaining instant rendering behavior

🧠 Improved caching strategy
In-memory caching ensures icons are reused without repeated parsing or network requests
Reduces UI latency and improves dashboard responsiveness

🔒 Enhanced reliability across browsers
Improved consistency in Safari, Chrome, and other frontend environments
Fixes edge cases where icons could fail to render on first load but appear after reload

🌐 Stable UI integration
Better compatibility with Home Assistant frontend rendering and UI styling systems
Improved behavior in dynamic and templated dashboard environments

🛠️ Internal changes
Refactored icon resolution to avoid asynchronous rendering during UI evaluation
Introduced synchronous fallback rendering model with async background hydration
Improved SVG parsing stability and sanitization consistency

⚠️ Notes
This update changes the internal rendering strategy to ensure icons are always available at render time. No configuration changes are required.

Initial release fix hacs.json

Full Changelog: 1.0.0...1.0.1

Initial release for custom_local_icons

What's Changed

• Add files via upload by @Mariusthvdb in #1

New Contributors

• @Mariusthvdb made their first contribution in #1

Full Changelog: https://github.com/Mariusthvdb/custom_local_icons/commits/1.0.0
custom_local_icons.zip