What is ha-companion-harmonyos?

HA Companion For HarmonyOS is a native mobile app that brings Home Assistant, a popular home automation platform, to devices running HarmonyOS NEXT, Huawei's operating system. The problem it solves is a compatibility gap: Home Assistant's official companion apps exist for Android, iOS, and smartwatch platforms, but HarmonyOS NEXT dropped Android app compatibility, leaving HarmonyOS users without an equivalent way to control their smart home from their phone or tablet. The app lets you log in to a Home Assistant server, browse your home dashboard through a built in web view, and register your HarmonyOS device with your Home Assistant instance. Once registered, your device can report sensor data back to Home Assistant, including battery level, charging state, network status, and location. Location support covers precise positioning, zone based geofencing, and background tracking. The app also supports local notifications, notification history, and a system authentication flow for locking the app with device credentials. An additional feature is service cards, interactive widgets powered by HarmonyOS's native card system, with initial templates for lights, media playback, and scenes. These cards can be bound to specific Home Assistant entities and refresh their data automatically. The project currently supports phone and tablet form factors, sharing one adaptive shell and one set of native settings screens across both. Because Home Assistant has no official OS label for HarmonyOS yet, the app registers itself using the Android label so it can reuse the existing companion protocol, which the README is careful to note does not mean the app is built on Android in any way. The project is written in TypeScript and is currently in an early development version. It is intended as an open source reference implementation rather than a published app, and the developer notes that push notifications and wearable support are not yet included, pending real device validation and appropriate distribution arrangements. Licensed under Apache 2.0.