Key Concepts
Quick rundown of the terms you’ll see in the app and these docs. Already familiar with Home Assistant? Skip to Setup.
Entities
Section titled “Entities”An entity is anything Home Assistant knows about — a light, a sensor, a lock, a speaker. Every entity has an ID like light.living_room and a state (like “on”, “72°F”, or “locked”).
Each tile on your watch represents one entity.
Domains
Section titled “Domains”The domain is the type of entity — the first part of the ID. light.kitchen is a light, lock.front_door is a lock, climate.thermostat is climate.
The domain determines what happens when you tap a tile, what controls you get on double-tap, and what icon shows up. WristAssistant supports 40+ domains.
A tile is how an entity shows up on your watch. It has an icon, shows the current state, and changes color when active. Tap to toggle, double-tap to open the control view. (This can be swapped in Settings → Interaction.)
You customize tiles on the iPhone app — icons, colors, animations, rules. You can also add a confirmation prompt to any tile so it asks before toggling — useful for things like garage doors or locks. The watch displays the result.
Pages are screens of tiles. Swipe left and right between them — rooms, categories, whatever grouping makes sense for you.
Most people use 3–6 pages. You can name them, reorder them, and add as many as you want.
Scenes and Scripts
Section titled “Scenes and Scripts”Scenes set multiple devices at once — “Movie Night” dims the lights and closes the blinds. Scripts run a sequence — “Good Morning” starts the coffee maker and sets the thermostat.
Both show up as tiles you can tap to activate.
How It All Connects
Section titled “How It All Connects”Home Assistant → iPhone App → Apple Watch (the brain) (the designer) (the remote)Home Assistant talks to your physical devices. The iPhone app is where you design your layout. The Apple Watch is where you control things. Changes on the iPhone sync to the watch automatically.
The watch connects to Home Assistant over Wi-Fi, your iPhone’s Bluetooth connection, or cellular. It’ll use your iPhone’s connection when available, but the iOS app doesn’t need to be open or running. The watch works on its own — even if your iPhone is off.
Quick Actions
Section titled “Quick Actions”Quick actions are radial shortcut menus. Long-press a tile and up to 8 shortcuts fan out — slide to one and release. Adjust a value, switch pages, send a TTS announcement, open a camera — all without lifting your finger.
Templates
Section titled “Templates”Template tiles show custom data using Jinja2 — the same language Home Assistant uses. Combine sensor readings, count open doors, display energy usage, or show anything you can express in a template.
Focus Filters
Section titled “Focus Filters”Focus Filters trigger Home Assistant actions when your iPhone’s Focus mode changes. Sleep Focus dims the lights. Work Focus adjusts the office. It all happens in the background.
Free vs. Premium
Section titled “Free vs. Premium”30-day free trial of everything. After that, free users keep 1 page, 1 complication, and basic customization. Premium is a one-time purchase (no subscription) that unlocks unlimited pages, complications, quick actions, camera streaming, and full customization.
Nothing gets deleted if you don’t upgrade. Buy Premium later and it all comes back.
Next Up
Section titled “Next Up”Ready to connect? Setup Guide →
Something not working? Troubleshooting →