Skip to content

Add Homebridge Config UI (homebridge-ui) and split device config into on_off/stateless sections#104

Merged
pponce merged 2 commits into
betafrom
codex/refactor-configuration-ui-and-update-documentation-fr9zf7
May 24, 2026
Merged

Add Homebridge Config UI (homebridge-ui) and split device config into on_off/stateless sections#104
pponce merged 2 commits into
betafrom
codex/refactor-configuration-ui-and-update-documentation-fr9zf7

Conversation

@pponce
Copy link
Copy Markdown
Owner

@pponce pponce commented May 24, 2026

Motivation

  • Provide a richer, user-friendly Homebridge Config UI X experience for Script2 by adding a custom UI and grouping device configuration into explicit on_off_switches and stateless_switches sections.
  • Preserve backward compatibility by keeping a legacy devices array and migrating support so existing installs do not break.

Description

  • Add a custom UI under homebridge-ui including public/index.html, public/index.js and a small UI server server.js that uses HomebridgePluginUiServer to serve the plugin configuration UI.
  • Update config.schema.json to enable customUi/customUiPath, introduce on_off_switches and stateless_switches arrays with full schema fields and validation, and keep a conditional legacy devices array for backward compatibility.
  • Update README.md to document the new UI-driven sections and migration notes, and add an Installation section and examples for both new grouped config and legacy devices config.
  • Bump package version and add the @homebridge/plugin-ui-utils dependency in package.json required by the UI server.

Testing

  • No automated tests were run for this change.

Codex Task

@pponce pponce merged commit 7cb13e5 into beta May 24, 2026
@pponce pponce deleted the codex/refactor-configuration-ui-and-update-documentation-fr9zf7 branch May 24, 2026 23:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant