Skip to content

Add Homebridge UI for Script2: split devices into on_off/stateless sections and include UI assets#102

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

Add Homebridge UI for Script2: split devices into on_off/stateless sections and include UI assets#102
pponce merged 2 commits into
betafrom
codex/refactor-configuration-ui-and-update-documentation-3tv93u

Conversation

@pponce
Copy link
Copy Markdown
Owner

@pponce pponce commented May 24, 2026

Motivation

  • Provide a friendly Homebridge Config UI X experience for Script2 by introducing a custom UI and a richer platform schema.
  • Separate configuration into explicit on_off_switches and stateless_switches to improve clarity while preserving legacy devices compatibility.
  • Ship an embedded UI and server shim so users can edit plugin config from Homebridge UI instead of raw JSON.

Description

  • Add a custom UI by including homebridge-ui/public/index.html, homebridge-ui/public/index.js, and a server entry homebridge-ui/server.js that uses HomebridgePluginUiServer.
  • Update config.schema.json to enable customUi, add on_off_switches and stateless_switches arrays with full property definitions and validation, and keep a conditional legacy devices array for backward compatibility.
  • Revise README.md to document the new UI sections, updated configuration examples, migration notes, installation instructions, and recommended child-bridge guidance.
  • Bump package version and add @homebridge/plugin-ui-utils dependency in package.json.

Testing

  • No automated tests were added or executed as part of this change.

Codex Task

@pponce pponce merged commit 4b0ddd4 into beta May 24, 2026
@pponce pponce deleted the codex/refactor-configuration-ui-and-update-documentation-3tv93u 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