v1.0.8: Fix static path registration using modern HA async API

v1.0.7 used the deprecated synchronous register_static_path() which
silently fails on HA 2024.x+, causing "Unable to load custom panel".
Now uses async_register_static_paths() with StaticPathConfig (the
correct API for HA 2024.1+), with a fallback to the legacy method.

Made-with: Cursor

Author: WJDDesigns

CHANGELOG.md

@@ -2,6 +2,11 @@
 
 All notable changes to Ultra Card Pro Cloud will be documented in this file.
 
+## [1.0.8] - 2026-02-25
+
+### Fixed
+- **Sidebar panel now actually loads** – v1.0.7 registered the static path using HA's deprecated synchronous API which silently fails on HA 2024.x+. Now uses `async_register_static_paths` (the correct modern API), with a fallback to the legacy method for older HA versions. Users who saw the "Unable to load custom panel" error after updating to v1.0.7 should update to this version.
+
 ## [1.0.7] - 2026-02-25
 
 ### Fixed

custom_components/ultra_card_pro_cloud/__init__.py

@@ -53,13 +53,22 @@ async def async_setup(hass: HomeAssistant, config: dict) -> bool:
     www_path = Path(__file__).parent / "www"
     if www_path.exists() and not hass.data.get(f"{DOMAIN}_static_registered"):
         try:
-            hass.http.register_static_path(
-                PANEL_STATIC_URL_PATH,
-                str(www_path),
-                cache_headers=True,
-            )
+            # Use the modern async API (HA 2024.x+). Falls back to the legacy
+            # synchronous method for older installations.
+            from homeassistant.components.http import StaticPathConfig
+            await hass.http.async_register_static_paths([
+                StaticPathConfig(PANEL_STATIC_URL_PATH, str(www_path), cache_headers=True),
+            ])
             hass.data[f"{DOMAIN}_static_registered"] = True
             _LOGGER.info("Registered static path %s → %s", PANEL_STATIC_URL_PATH, www_path)
+        except (ImportError, AttributeError):
+            # Fallback for HA versions that don't have async_register_static_paths
+            try:
+                hass.http.register_static_path(PANEL_STATIC_URL_PATH, str(www_path), cache_headers=True)
+                hass.data[f"{DOMAIN}_static_registered"] = True
+                _LOGGER.info("Registered static path (legacy) %s → %s", PANEL_STATIC_URL_PATH, www_path)
+            except Exception as static_err:
+                _LOGGER.warning("Could not register static path for panel JS: %s", static_err)
         except Exception as static_err:
             _LOGGER.warning("Could not register static path for panel JS: %s", static_err)
     elif not www_path.exists():

custom_components/ultra_card_pro_cloud/manifest.json

@@ -11,5 +11,5 @@
   "iot_class": "cloud_polling",
   "issue_tracker": "https://github.com/WJDDesigns/ultra-card-pro-cloud/issues",
   "requirements": [],
-  "version": "1.0.7"
+  "version": "1.0.8"
 }

version.py

@@ -3,4 +3,4 @@
 This is the single source of truth for version information.
 """
 
-__version__ = "1.0.7"
+__version__ = "1.0.8"