Home Assistant dashboards inspired by Apple’s Home app.
Built from your own rooms and devices, and set up entirely in the UI.
Built and designed using Claude Opus for the code and Codex for the image assets.
Install · Documentation · Gallery · What’s new
Add a screen and HK Frontend builds it from your floors, areas and devices: the clock and weather, status chips, cameras, scenes, favorites, a section for every room, a page for each room and each kind of device, and a calendar of the month, week or day. A new light shows up on its own. The same screen works on a wall tablet, a computer, an iPad and a phone.
Every screen chooses how you move between its pages and rooms.
- A menu like the Home app's sidebar: always open beside the page, behind a button, or pulled out with a swipe from the left edge. (Menu)
- A floating tab bar like iOS apps have, along the bottom or the top, or as a rail down either side of a tablet.
- It can shrink to a small button or hide as you scroll, and even start small.
- Small, Medium or Large, and you choose how many pages get a tab.
- The page moves smoothly clear of it, so nothing important hides underneath.
- More holds the rest: the other pages, every room, and Home Assistant's own Settings, Integrations and Notifications, as icons or as a list. (Tab Bar)
Tap a light, thermostat, lock, garage door, speaker or vacuum and a sheet opens with the controls it needs. Each room and category page has a status row like the Home app's: Motion · Emma’s Room, Valve · Running. Pop-ups show the doorbell camera or the alarm keypad, and an automation can open one on chosen screens. Tiles have the Home app’s own size and spacing, in Apple’s font wherever it is there. Every accessory can have its own name, icon (any of Apple’s Home glyphs, or Home Assistant’s), tile size and place among its neighbors. Touch a graph for its value, drag a thermostat’s dial and watch it follow your finger.
Behind every page, a sky that follows the weather and the time of day: clear and starry, golden at sunset, gray and flashing in a thunderstorm, with rain or snow when it falls. Choose Realistic clouds — photographic clouds picked from the weather and lit by the sun — and New Decorations, woodland scenery that comes alive for autumn, Halloween, Christmas, birthdays and the rest of the year. Or set the Background to a still Color, a Photo of your own, or Landscapes — fifty photos that come with it, a new one each time the screen wakes or on a schedule — softened with its own blur, dim and tint, for every screen, one screen, a page or a room. Liveliness sets how much moves in it — the bats, leaves and fireflies, and how often something crosses the moon — for each occasion and each screen, calming down when nobody is around.
Put a screen on a wall tablet and it looks after itself. It returns to Home when left alone, and fills the screen with no Home Assistant header or sidebar. Each tablet has its own page in HK Settings: whether it is awake, on the screensaver or dark, and why, its battery, what it does when left alone, and its Sleep Screen. (Wall Tablets)
When nobody is using it, it shows your photos (one at a time, or a mosaic of up to five), a full-screen clock in fifteen styles over a moving background or fifty landscape photos that come with it (with a dim red Night Mode), or the forecast over a living landscape: the sky, the clouds and the light of the moment. Now and then Weather (today at a glance, over the live sky) or Home Energy (today's energy, cost and water against a usual day, in the Energy page's rings) comes in. The landscape dresses up for Halloween, Christmas, the Fourth of July and birthdays, like the dashboards. Over the top go the clock, the weather, what's playing, the timers and whether the house is secure, with your coming events beside them if you like. (Screensaver and idle)
Sleep Screen keeps each tablet dark when nobody needs it and awake the moment somebody does. HK Frontend decides from the room’s presence sensors, quiet hours, the doorbell, smoke and away mode, sets the brightness for day and night, and fades in from black without a flicker — or your own automations decide, with one action.
The Energy feature builds an Energy page from Home Assistant’s own Energy settings, with four tabs: Now (the whole home live, what is drawing the most, the house battery and the cars), and Today, This Week and This Month (rings against a usual day, where the energy went, the month as a calendar, and the meters you track). Every circuit, room, appliance and outlet has a tile, with a power button where there is a switch. Beside it, a Power page for right now and the controls: the grid, the sun, a house battery with its mode and levels, the cars charging, and every device marked when the battery backs it up. A screen can show only some pages — a wall panel that is just the Energy page, say.
HK Settings in the sidebar holds everything, with a live preview of each screen as a phone, an iPad, a wall tablet, a desktop or a car. Choose the glass: see-through, frosted, blurred, or Tinted, the Home app’s flat dark plate. A Setup Assistant makes your first screen, and Setup Check says what is missing. There is nothing to add to configuration.yaml.
You need Home Assistant 2026.8 or newer and HACS.
- In HACS, open ⋮ → Custom repositories, add
https://github.com/jazzphone/hk-frontendas an Integration, then download HK Frontend. - Restart Home Assistant.
- In Settings → Devices & services, select Add integration and choose HK Frontend.
- Open HK Settings in the sidebar. The Setup Assistant starts on its own.
Step by step, with what you should see: Install. Apple’s font and glyphs are optional and can’t be bundled; Your files shows how to add your own.
Add each from Settings → Devices & services → HK Frontend → Add feature.
| Music | Whole-home music through Music Assistant: one Music page to play and browse, rooms, speaker groups and playlists, a docked Now Playing bar, and the music on the screensaver |
| Live TV | An HDHomeRun tuner’s channels and guide, full screen on any screen |
| Clean Areas | Pick rooms and send the vacuums that reach them |
| Alarm PIN | A PIN in front of an alarm panel that takes no code of its own |
| Energy | An Energy page built from Home Assistant’s Energy settings, with a live tile per circuit and device, and a Power page for right now: the grid, the sun, a house battery and the cars |
| Notifications | A banner at the top of the screens when something happens at home, with a camera’s snapshot; whole categories at once — doors, locks, leaks, cameras, vacuums, the alarm — and your calendars’ events before they start. A tap opens the accessory’s sheet with the notification on it. Do Not Disturb, and a wake up to the screensaver |
The Weather page combines current conditions, hourly Temperature / Rain / Wind tabs, the daily forecast and detail tiles over the live sky. Its built-in radar uses NOAA or RainViewer over OpenStreetMap, with a centered regional view and controls in the expanded map. Choose its sources, forecasts and radar in HK Settings → Pages → Weather; no separate HACS radar card is required.
Built in, nothing to add: the Calendar (month, week or day, and your coming events on the screensaver), Weather, Cameras, Pop-ups an automation opens (the doorbell, the alarm keypad), the Screensaver and the Sleep Screen.
HK Frontend is HK inside Home Assistant. Mantel is its sibling: the same screens, from the same code, served by a server of its own beside Home Assistant, with people and roles, wall tablets that sign themselves in and an audit log of every command. Use either, or both together: linked, Mantel's Owner picks who runs each wall tablet, and every entity keeps its id. While Mantel runs the house, HK Frontend’s dashboards use Mantel’s settings, one copy. HK Frontend and Mantel compares them.
Start with Troubleshooting. To report a problem, open an issue and attach the diagnostics (Settings → Devices & services → HK Frontend → ⋮ → Download diagnostics).
Screenshots are of one home that has added Apple’s font and glyphs; camera pictures are blurred. HK Frontend is an independent project, not affiliated with or endorsed by Apple Inc. Apple, HomeKit, SF Pro and SF Symbols are trademarks of Apple Inc. The seasonal sky illustrations were generated with OpenAI’s image tools, and the cloud, rain and snow textures by tools/sky/gen_sky.py; until you add your own glyphs, icons come from Material Design Icons (Apache 2.0). MIT license.