Setup Guide
What You Need
Section titled “What You Need”- iPhone running iOS 17+
- Apple Watch running watchOS 10+ (paired with your iPhone)
- Home Assistant 2024.1 or newer
- HACS installed on your Home Assistant (install guide)
Search for WristAssistant in the App Store and install it. Open the app on your iPhone and the onboarding walks you through everything — connecting to your Home Assistant server, picking devices, and building your layout.
The app will automatically install the WristAssistant HACS integration on your server if HACS is present. If you don’t have HACS yet, you’ll need to install it first — it’s required.
{/* video: onboarding flow */}
How the Watch Connects
Section titled “How the Watch Connects”The watch finds the fastest path to Home Assistant automatically:
- Wi-Fi — Direct connection, near-instant response
- iPhone relay — Routes through your phone via Bluetooth when Wi-Fi isn’t available
- Offline — Shows last known states until a connection comes back
The connection dot (to the right of the clock on your watch): green = connected, orange = connecting, red = offline.
What Watches Are Supported?
Section titled “What Watches Are Supported?”Any Apple Watch running watchOS 10+. Some features need specific hardware:
- Hand gestures (double-pinch) — Series 9, Ultra 2, or newer
- Action Button — Ultra models only
- Control Center widgets — watchOS 26+
Next Up
Section titled “Next Up”Something not working? Troubleshooting →