What problem does this solve?
Devices like the Inovelli VZM35-SN expose dozens — sometimes hundreds — of state/action toggles (Default LED 1–7 Colour When On, Intensity When Off, etc.). Each row currently renders the Z2M schema description directly under the title:
Intensity of LED strip when on. 101 = Synchronized with default all LED strip intensity parameter.
That's three lines of muted body text per row, repeated almost verbatim across many rows. The list becomes unscannable — the user has to hunt for the title/value through walls of repetitive description text. Screenshot in the original report shows it: six rows fill the screen and you can only see four parameter names.
What would you like Shellbee to do?
Drop the description text from device state/action card rows entirely. Show only:
- Icon
- Title (the parameter name)
- Current value
- The control itself (slider, toggle, field)
No description, no info icon, no expand chevron. Users who need to know what a parameter does can consult the Z2M docs / device manual — Shellbee's job here is fast access, not first-time learning.
Scope: This change applies only to device state/action cards (the toggles/sliders/fields on a device's detail screen). Other screens that surface schema descriptions — bridge settings, group options, etc. — are out of scope and keep their current layout.
No setting / toggle: Ship the cleaner layout for everyone. Don't add a preference.
Does the Z2M web frontend already do this?
Partially — the Z2M frontend keeps descriptions inline but the web layout has horizontal room to absorb them. On a phone-width column, the same content turns into vertical clutter. This is a Shellbee-specific tightening for mobile.
Alternatives you've considered
- Tap title / info icon to reveal description — adds an affordance and a tap target for content most users will never need.
- Long-press to reveal — undiscoverable.
- Truncate to one line with chevron — first line of these descriptions is rarely the useful part, and the chevron itself adds visual noise across dozens of rows.
- Settings toggle to opt back in — preference surface area for a feature that should just be a default.
What problem does this solve?
Devices like the Inovelli VZM35-SN expose dozens — sometimes hundreds — of state/action toggles (Default LED 1–7 Colour When On, Intensity When Off, etc.). Each row currently renders the Z2M schema description directly under the title:
That's three lines of muted body text per row, repeated almost verbatim across many rows. The list becomes unscannable — the user has to hunt for the title/value through walls of repetitive description text. Screenshot in the original report shows it: six rows fill the screen and you can only see four parameter names.
What would you like Shellbee to do?
Drop the description text from device state/action card rows entirely. Show only:
No description, no info icon, no expand chevron. Users who need to know what a parameter does can consult the Z2M docs / device manual — Shellbee's job here is fast access, not first-time learning.
Scope: This change applies only to device state/action cards (the toggles/sliders/fields on a device's detail screen). Other screens that surface schema descriptions — bridge settings, group options, etc. — are out of scope and keep their current layout.
No setting / toggle: Ship the cleaner layout for everyone. Don't add a preference.
Does the Z2M web frontend already do this?
Partially — the Z2M frontend keeps descriptions inline but the web layout has horizontal room to absorb them. On a phone-width column, the same content turns into vertical clutter. This is a Shellbee-specific tightening for mobile.
Alternatives you've considered