Layout Editor
The iPhone app is where you design your watch layout. Everything syncs automatically.
{/* video: the editor in action */}
The Preview
Section titled “The Preview”A watch-shaped preview shows roughly how your layout will look. It matches your actual watch screen size — what you see is what you get.
Adding Devices
Section titled “Adding Devices”Tap the add button to browse your Home Assistant entities:
- Search — Find anything by name
- By type — All lights, all switches, all cameras
- Bulk add — Select several at once
- Smart pages — Auto-generated pages based on state (e.g., all lights that are on, all doors that are unlocked)
{/* video: browsing and adding entities */}
Arranging Tiles
Section titled “Arranging Tiles”Drag tiles to rearrange. Resize by tapping a tile and adjusting its size.
Editing a Tile
Section titled “Editing a Tile”Tap any tile to open its settings.
{/* video: customizing a tile */}
-
Size — Make important tiles bigger, keep secondary ones compact. Default is 6x4. Tiles go from 1x1 up to 12 wide by any height — a single tile can fill the entire screen.
-
Icons — Over 6,000 SF Symbols to choose from. Default icons change automatically based on state — lightbulb fills in when on, lock shows locked/unlocked. Or pick any icon you want.
-
Colors — Set background, icon, and label colors independently. Different colors for active and inactive states.
-
Labels — Show the entity name, custom text, or hide the label and go icon-only. Numeric values can display as plain text, a fill bar (like a battery indicator), or a pill badge.
-
Patterns — Background patterns — stripes, dots, crosshatch, chevrons — help differentiate tile types at a glance. Adjustable color, opacity, and scale.
-
Borders — Custom borders with adjustable width, color, and corner radius. Borders can also be animated — pulse, shimmer, rainbow, chase, sparkle, comet, and others. Animated borders may use more battery.
-
Animations — Tiles can animate on state change, while a device is active, or on tap — pulse, shake, bounce, glow, and others. Tiles can also have overlay effects — animated backgrounds like aurora, rain, fire, sparkle, etc. Animations may use more battery.
-
Value Bars — For tiles showing a percentage (brightness, volume, position), add a visual bar across the top, bottom, or as a fill.
Confirmation Prompts
Section titled “Confirmation Prompts”Add a confirmation prompt to any tile so it asks “Are you sure?” before toggling. This prevents accidental activations — especially useful for garage doors, locks, alarm panels, or anything with real-world consequences.
Set it up by tapping a tile → Confirmation toggle.
Quick Actions
Section titled “Quick Actions”Configure up to 8 quick action slots per tile. Tap a tile → Quick Actions → add slots with custom icons and colors. Each slot can toggle a device, run a scene/script, switch pages, send a TTS message, open a camera, broadcast audio, or show info.
Managing Pages
Section titled “Managing Pages”Tap back or the Pages button on the bottom nav bar. From here you can:
- Add pages — Tap “Add Page” to create a new one
- Reorder pages — Drag to rearrange
- Rename pages — Tap the page name
- Delete pages — Swipe to delete
- Duplicate pages — Copy an existing layout as a starting point
- Themes — Apply a color scheme to an entire page
- Smart Pages — Create auto-populating pages based on rules
Groups
Section titled “Groups”Select multiple tiles → Group to link them together. Grouped tiles share visual styles — backgrounds, borders, and animations. Edit the group once and every tile in it updates. More at Groups.
Syncing to Watch
Section titled “Syncing to Watch”For the initial sync, make sure both the watch app and the iPhone app are open and in the foreground. After that, changes sync whenever the iPhone app is active and the watch is connected. Toggling any setting forces a sync.