How To Test Upcoming Changes

How To Test Upcoming Changes

Node.js Version

• ️⚠️ The hb-service backend now has a stricter Node.js version requirement:
  • if you are running Node.js v20, then you must be running at least v20.19.0
  • if you are running Node.js v22, then you must be running at least v22.12.0
  • if you are running Node.js v24, then you must be running at least v24.0.0
    • although remember that v24 is not officially supported yet
• The UI will not allow you to update to UI v5.2.0 if you are running an unsupported version of Node.js
• Check the Homebridge Wiki for instructions on how to update Node.js on your system

Other Changes

• update node engines to ^20.19.0 || ^22.12.0 || ^24.0.0

Homebridge Dependencies

• @homebridge/hap-client @ v3.0.0
• @homebridge/node-pty-prebuilt-multiarch @ v0.13.1
• @homebridge/plugin-ui-utils @ v2.1.0

⚠️ Do not update if:

• you are running Node.js v20, and your version is lower than v20.19.0
• you are running Node.js v22, and your version is lower than v22.12.0

UI Changes

• only show hbv2 readiness icon when ready to show
• migrate to use fetch() for http requests
• Fix alignment of Plugin Updates in Horizontal Mode (#2495) (@NorthernMan54)
• offer to download a backup before updating homebridge/ui
• updates to the he.json language file (@seidnerj)
• pass through plugin display name to logs after update
• fix accidental hiding of startup settings section

Homebridge Dependencies

• @homebridge/hap-client @ v3.0.0
• @homebridge/node-pty-prebuilt-multiarch @ v0.13.1
• @homebridge/plugin-ui-utils @ v2.1.0

⚠️ Breaking Changes

• This version of the Homebridge UI:
  • Is compatible with Homebridge v1 and v2-beta, with no plans to drop support for Homebridge v1 in the near future.
  • Drops support for Node.js v18 and earlier, so please update to v20 or v22 - more info on updating
  • Drops support for Raspberry Pi devices running on the armv6 architecture (like the Pi 1 and Pi Zero) - please update your hardware
  • Drops support for instances using pnpm as the package manager - consider updating your Homebridge instance to use npm instead - more info on updating

UI Changes

• updates to the fi.json language file (#2253) (@l1500s)
• update default dashboard layout
• add support for dark mode switching with custom plugin uis (@NorthernMan54)
• Display Docker Version Details in the Update Information Box (#2488) (@NorthernMan54)
• allow to reinstall installed versions of plugins

Other Changes

• improvements to the deprecate versions workflow
• retire use of pnpm and code references
• bump the default node version from 20 to 22
• make terminal enabled by default on new macOS hb-service installs
• set service mode as default, remove standalone
• Initial support for NodeJS 24 in preparation for LTS in Fall of 2025 (#2451) (@NorthernMan54)
• update fastify and nestjs dependencies

Homebridge Dependencies

• @homebridge/hap-client @ v3.0.0
• @homebridge/node-pty-prebuilt-multiarch @ v0.13.1
• @homebridge/plugin-ui-utils @ v2.1.0

• This version of Homebridge UI is likely to be the last minor version on the v4.x branch.
• The 4.x branch will continue to receive security updates and bug fixes for the foreseeable future.

Other Changes

• update github url for plugin bundle downloads
• allow displaying some accessories with a robot vacuum icon in the ui
• do not return deprecated versions of npm packages across the ui
• add workflow for deprecating old versions of Homebridge UI

Homebridge Dependencies

• @homebridge/hap-client @ v3.1.0
• @homebridge/node-pty-prebuilt-multiarch @ v0.11.14
• @homebridge/plugin-ui-utils @ v2.1.0

UI Changes

• updates to the th.json language file (#2482) (@tomzt)
• updates to the th.json language file (#2483) (@tomzt)
• updates to the nl.json language file (#2487) (@hendriksen-mark)
• various updates to the backup/restore modal
• fix list of selected network adapters in modal
• battery - style as green when charging
• thermostat - open control modal on long click
• show release notes when npm and gh release match
• add control modal for filter to reset filter life
• show bool characteristic descriptions in info modals
• show colour temp values in mired and kelvin
• add saturation control to lightbulb control modal
• add transparency to slider handles in accessory control modals
• obtain hb/ui changelog from the most recent github tag
• add plugin support button and modal
• add plugin search button, hide bar by default
• add tab in plugins showing plugin analytics in iframe
• allow applying a custom service to an accessory's service
  • change between Switch, Outlet, Lightbulb, Fan, Television, Valve, AirPurifier, Heater, Cooler, Humidifier, Dehumidifier for these accessory types
  • change between Door, Window, WindowCovering for these accessory types
  • change between Doorbell, Microphone, Speaker, SmartSpeaker for these accessory types
  • this can be set in the accessory info modal, more options to come in the future
• custom service changing - add more to group one
• add option to show npm version with node version
  • this can be enabled in the update info widget settings by clicking the spanner icon in the top right corner of the widget on hover (from a desktop, when in unlocked mode)
• add control modal for smart speaker accessories
• prevent accessory control modal open when loading
• add control modal for doorbell accessories
• add control modal for microphone accessories
• allow custom type changing - doorbell, microphone, speaker

Other Changes

• code cleanup inside angular module files
• refactor ui types into interface files
• rename hap icon files for consistency
• rename accessory type component files for consistency
• angular-wide code refactoring and cleanup

Homebridge Dependencies

• @homebridge/hap-client @ v3.1.0
• @homebridge/node-pty-prebuilt-multiarch @ v0.11.14
• @homebridge/plugin-ui-utils @ v2.1.0

Other Changes

• when updating plugin, obtain latest changelog from github

Homebridge Dependencies

• @homebridge/hap-client @ v3.1.0
• @homebridge/node-pty-prebuilt-multiarch @ v0.11.14
• @homebridge/plugin-ui-utils @ v2.1.0

UI Changes

• fix accessory control modals closing on clicking outside the modal
• small tweaks to various accessory status tiles
• revert display of triggered state in security control modal
• show spinner on settings page until all settings are loaded
• show both version notes and full changelog beforehand on plugin update

Other Changes

• remove bridge id from control blacklist when removing a bridge
• fix regex for blacklist in config schema file
• bring runner list for actions up-to-date with github availability

Homebridge Dependencies

• @homebridge/hap-client @ v3.1.0
• @homebridge/node-pty-prebuilt-multiarch @ v0.11.14
• @homebridge/plugin-ui-utils @ v2.1.0

⚠️ Default Theme Change:

• The default theme for Homebridge UI has been changed from orange to deep-purple.
  • If you want to change the theme back to orange, you can do so in the settings page.

UI Changes

• updates to the th.json language file (#2472) (@tomzt)
• auto restart after version change of hb or ui
• redesigned setup wizard page
• style HBv2/UIv5 icons on status page based on readiness
• security system modal only show valid modes
• refactor settings page with immediate saving
• add support for uiSchema within plugin configurations
• add option to hide update notifications for specific plugins
• improve plugin search and result ordering (@justjam2013)
• add icon and tile for filter maintenance accessory

Other Changes

• Removed redundant Google Smart Home components (@NorthernMan54)

Homebridge Dependencies

• @homebridge/hap-client @ v3.1.0
• @homebridge/node-pty-prebuilt-multiarch @ v0.11.14
• @homebridge/plugin-ui-utils @ v2.1.0