Overview
The Dashboard Search bar appears above the card grid whenever your device has at least one card. It lets you narrow down what is visible using free-text search, type filter chips, a room dropdown, or any combination of the three. Filters are applied instantly (with a 150 ms debounce on text input) and are cleared automatically when you navigate to a different device.
How to Use
Text Search
Type any part of a card's display name into the search field. Matching is case-insensitive and substring-based, so typing temp will surface cards named "Temperature", "Temp Sensor 1", and so on. A small x button appears inside the field while text is present — click it to clear just the text query without resetting the other filters.
Type Filter Chips
Five chips appear below the search field:
- All — default, shows every card type
- Sensors — shows only sensor reading cards
- Actuators — shows only actuator toggle cards
- PIDs — shows only PID controller cards
- Alerts Only — shows only sensor cards that currently have an active alert breach
Tapping a chip toggles it active; tapping All returns to the unfiltered view.
Room Filter
When a device has more than one room, a room dropdown appears to the right of the search field. Select a room name to restrict results to that room only. The dropdown is hidden on single-room devices to reduce clutter.
Clearing Filters
A Clear button appears in the toolbar row whenever any filter is active (text entered, chip other than All selected, or room chosen). Clicking it resets all three filters at once. You can also press Escape while the search field is focused to clear everything and dismiss focus.
Keyboard Shortcuts
- Press
/from anywhere on the dashboard page to jump focus to the search field. - Press
Cmd+K(macOS) orCtrl+K(Windows/Linux) to do the same. - Press
Escapewhile the search field is focused to clear all filters and return focus to the page.
These shortcuts are inactive when focus is already inside any text input, textarea, or select element.
What Gets Filtered
The search and filter chips match against the display name of each card:
- Sensor cards — matched against the sensor's display name from the sensor registry.
- Actuator cards — matched against the actuator's display name from the actuator registry.
- PID cards — matched against the PID controller's display name from the PID registry.
- Setpoint cards — matched against the setpoint key suffixed with "setpoint" (e.g.,
temperature setpoint).
Blank spacer cards are never hidden by any filter — they stay in place to preserve layout structure.
Hidden cards (cards you have manually hidden via the card context menu) are still subject to filter matching. If a hidden card matches your query it will appear with its normal reduced-opacity hidden style.
Result Count
When any filter is active, a small count appears on the right side of the chip row, for example "Showing 3 of 12". This count excludes blank spacers and counts only signal cards.
Troubleshooting
The search bar is not visible. The bar only renders once your device has at least one card and has finished loading. If the dashboard is still in a loading state or no signals have been published yet, the bar is hidden.
I filtered by "Alerts Only" but no cards appear even though I have active alerts. The Alerts Only chip only surfaces sensors with an active alert breach at that moment — it reflects the live alertState from the device. If alerts have already cleared or if alert configs have not been configured for your sensors, no cards will match. Check that alert thresholds are set in the sensor's threshold editor and that the sensor value has breached one.