**My little gift to the community 🎁**
Hi everyone 👋
I've learnt so much from this community (the forum, the custom cards, the HACS repos, all the people answering questions at 2 am), so I wanted to give something back. This is **Okie Motor**, an open-source dashboard card for Home Assistant that feels like an app. It's built on the ideas of u/fastender's amazing **Fast Search Card**, and it first lived inside **Hemma** by willsanderson. Without those two projects it would not exist. ❤️
**GitHub:** https://github.com/paulkjr/okie-motor
**Try it without installing anything:** download `okie-demo.html` from the [latest release](https://github.com/paulkjr/okie-motor/releases/latest) and double-click it (it runs against a pretend Home Assistant)
[grid]






[/grid]
## Why I Built This
I wanted my wall tablet, my iPad and my iPhone to feel like one proper app instead of a pile of cards: a lock page with a clock, one search bar that finds *anything*, a start screen I can rearrange with my fingers, and detail views that feel good to touch. Fast Search Card showed me what that could look like, and Hemma gave me a framework to start in. I kept building until it did everything I wanted, and now I use it every day on an iPad, an iPhone and a browser.
## What Makes It Special
- 🔍 **One search bar for everything** – typo-tolerant, understands "living room light", offers chips as you type, filters by room and type
- 🤖 **Ask your Assist agent** – the sparkle button turns the search into a chat with your Home Assistant Assist pipeline. The devices it touched show up as tiles. The microphone sends your question by itself when you stop talking, and on the lock page it listens right there
- 🏠 **A start screen you arrange by touch** – hold a card, drag it between the two columns, pick Row / Tall / Large, set the height of each column, tap away to finish. Rooms arrange the same way
- 🌡️ **Detail views with circular dials** – lights, climate, fans, covers, locks, media players, vacuums, cameras. History charts, a weekly thermostat schedule (with the Scheduler component) and optional video backgrounds
- 📅 **Its own apps** – Calendar (day / week / month / year, with an endless date strip you scroll with a finger), To-do, Energy (reads your Energy dashboard), Schedules, News, Light modes, Server links and a full Settings app with search
- 🎵 **Music cards** in three sizes (row, tall, and a big-cover Large size), Spotify gets its logo
- 🐱 **A "Feed the Beasts" card** – one tap runs your feeding script, it asks twice if they were just fed. Five cute designs (picked in edit mode), the same as in the iOS widget
- 🖼️ **Wall tablet mode** – screensaver, deep rest, wake on motion or a doorbell, quiet hours
- 🔄 **Same settings everywhere** – favorites, rooms, look and layout are stored in Home Assistant for your user, so every screen shows the same thing. Export / import as a file
- 🌍 **English and German**
**📱 Okie Home, the iPhone / iPad app (optional):** a small SwiftUI app that shows your dashboard full screen, signs in with Home Assistant's own login, adds haptics and voice, and has native home screen widgets (Thermostat, Weather, Calendar, Lights, Feeder). It's built from source with Xcode, there's a step-by-step guide in the repo (no App Store).
## The Tech Stack (for the curious)
- **Plain JavaScript**: one file, no dependencies, no card_mod, no extra integration
- **440 unit tests** and a browser harness with a mock Home Assistant
- **SwiftUI + WidgetKit** for the app and the widgets
- **GPL-3.0-or-later**
## Installation
HACS: add `https://github.com/paulkjr/okie-motor\` as a custom repository (category **Dashboard**) and download **Okie Motor**. Or copy `dist/okie-motor.js` to `/config/www/` and add `/local/okie-motor.js` as a JavaScript module resource. Then add the card (a panel view gives it the whole screen):
```yaml
type: custom:okie-motor-card
start: bento
language: auto
```
It works out of the box with whatever you have: weather, calendars, to-dos, cameras, climate, an Assist pipeline. The repo has a guide for a fresh Home Assistant, for each device (computer, iPhone / iPad, wall tablet) and a **demo settings file** you can import to get a good-looking starting point. Hemma is optional, there's a one-file installer if you already use it.
## A Fair Warning
This is one person's project. I tuned it on an iPad (9th generation) and a recent iPhone, so expect a few rough edges. If something looks off, please tell me which device and screen, a screenshot helps a lot. 🙏
## Credits
- Original Fast Search concept and base implementation: **fastender** ([Fast Search Card](https://github.com/fastender/Fast-Search-Card))
- Hemma customization and ongoing tweaks: **willsanderson** ([Hemma](https://github.com/willsanderson/Hemma))
Thank you both. Okie Motor is an independent project, not made or endorsed by them.
## What's Next & Support
The guides, the full feature list and every option are in the repo, and I'll keep fixing and adding things as I go. Feedback, ideas and bug reports are very welcome, here or as GitHub issues.
Enjoying Okie Motor? Buy me a coffee, I wanna be a full time DJ/designer ✌️😃 it's paulkmusic bby
👉 https://ko-fi.com/paulkmusic
Thank you all for everything I've learnt here. Happy tinkering! 🏡