chore: release 26.12-alpha

Bridge-mode networking with explicit 8123:8123 port mapping. Image is
homeassistant/home-assistant:stable — upstream's recommended production
tag, same image as the Docker Hub link in #1.

One Docker-managed volume (`furtka_home-assistant_config`). No
manifest.settings — onboarding (admin user, home location, units) is
the standard Home Assistant in-browser flow on first visit to :8123,
same shape as Jellyfin and Uptime Kuma.

Cloud integrations (Hue Cloud, Tado, Sonos via account) work today.
Local-discovery integrations that need host networking, Bluetooth, or
Zigbee/Z-Wave dongle passthrough are explicitly deferred — listed as
a follow-up once the manifest schema grows a network_mode knob.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

CHANGELOG.md

@@ -6,6 +6,19 @@ Versioning: CalVer (`YY.N`) — same scheme as the core Furtka repo.
 
 ## [Unreleased]
 
+## [26.12-alpha] - 2026-04-28
+
+### Added
+
+- **Home Assistant** (v1.0.0, image `homeassistant/home-assistant:stable`,
+  daniel/furtka-apps#1). Smart-home hub for lights, sensors, and locally
+  controlled devices. Bridge-mode networking with explicit `8123:8123`
+  port mapping for v1 — Cloud integrations (Hue Cloud, Tado, Sonos via
+  account) work, mDNS/Bluetooth/Zigbee-stick discovery deferred until a
+  manifest `network_mode` knob lands. One Docker volume (`config`),
+  no manifest settings — onboarding (admin user, home location, units)
+  happens in the browser on first visit to `:8123`.
+
 ## [26.11-alpha] - 2026-04-21
 
 ### Fixed
@@ -87,7 +100,8 @@ Versioning: CalVer (`YY.N`) — same scheme as the core Furtka repo.
   the vendored `furtka.manifest.load_manifest` + cross-checks compose
   volume references).
 
-[Unreleased]: https://forgejo.sourcegate.online/daniel/furtka-apps/compare/26.11-alpha...HEAD
+[Unreleased]: https://forgejo.sourcegate.online/daniel/furtka-apps/compare/26.12-alpha...HEAD
+[26.12-alpha]: https://forgejo.sourcegate.online/daniel/furtka-apps/releases/tag/26.12-alpha
 [26.11-alpha]: https://forgejo.sourcegate.online/daniel/furtka-apps/releases/tag/26.11-alpha
 [26.10-alpha]: https://forgejo.sourcegate.online/daniel/furtka-apps/releases/tag/26.10-alpha
 [26.9-alpha]: https://forgejo.sourcegate.online/daniel/furtka-apps/releases/tag/26.9-alpha

apps/home-assistant/docker-compose.yaml

@@ -0,0 +1,38 @@
+# Furtka Home Assistant — smart-home hub.
+#
+# Bridge networking + explicit `8123:8123` port mapping. Upstream's own
+# docs lean toward `network_mode: host` because that's what mDNS-based
+# discovery, Bluetooth, HomeKit, and Zigbee/Z-Wave dongles need. We're
+# deliberately starting in bridge mode for v1: it keeps the catalog's
+# network model consistent (every other app is bridged), and Cloud-only
+# integrations (Hue Cloud, Tado, Sonos via account, etc.) work fine.
+# Host networking + USB passthrough is a follow-up once the manifest
+# schema grows a `network_mode` knob.
+#
+# Image pin: `homeassistant/home-assistant:stable` is upstream's
+# recommended tag for production — release-train, not bleeding edge.
+# Same image as the Docker Hub link Robert pointed at in the new-app
+# request (#1).
+#
+# No HEALTHCHECK override needed: the upstream image's healthcheck is
+# tame, and a temporarily-yellow status during the first-boot DB
+# migrations is expected behaviour.
+#
+# No manifest.settings — Home Assistant's onboarding (admin user, home
+# location, units) happens entirely in the browser on first visit, just
+# like Jellyfin and Uptime Kuma. Nothing for the install form to ask.
+
+services:
+  homeassistant:
+    image: homeassistant/home-assistant:stable
+    restart: unless-stopped
+    ports:
+      - "8123:8123"
+    environment:
+      - TZ=Europe/Berlin
+    volumes:
+      - furtka_home-assistant_config:/config
+
+volumes:
+  furtka_home-assistant_config:
+    external: true

apps/home-assistant/icon.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="3" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M10 30 L32 10 L54 30 V52 H10 Z"/>
+  <circle cx="32" cy="36" r="5"/>
+  <path d="M32 10 V4 M22 22 L18 18 M42 22 L46 18"/>
+  <path d="M22 44 H42"/>
+</svg>

apps/home-assistant/manifest.json

@@ -0,0 +1,11 @@
+{
+  "name": "home-assistant",
+  "display_name": "Home Assistant",
+  "version": "1.0.0",
+  "description": "Smart-home hub for lights, sensors, and locally controlled devices.",
+  "description_long": "Steuere Lampen, Heizung, Sensoren und Smart-Home-Geräte von einem zentralen Dashboard aus. Beim ersten Aufruf im Browser unter http://furtka.local:8123 wird das Admin-Konto angelegt und die Wohnung eingerichtet. Zigbee-/Z-Wave-USB-Sticks und automatische Geräteerkennung über mDNS/Bluetooth sind in dieser ersten Version noch nicht verdrahtet — die App läuft im Bridge-Modus auf Port 8123. Cloud-Integrationen (Hue Cloud, Tado, Sonos via Account) funktionieren ohne Einschränkung.",
+  "volumes": ["config"],
+  "ports": [8123],
+  "icon": "icon.svg",
+  "open_url": "http://{host}:8123/"
+}