Release 0.15.0 from 27.06.2025

[Apollon77]

matter.js 0.15.0 – Matter Groups, New JS Runtimes, and More

We’re excited to announce the release of matter.js version 0.15, the JavaScript SDK for the Matter smart home standard!

What’s New in Version 0.15

This release brings significant enhancements in three areas: support for Matter Groups, broader compatibility across JavaScript platforms, and improvements to the Controller features. As always, it also includes a range of bug fixes and general optimizations.

matter.js v0.15 now offers full support for Matter Groups as defined in the Matter specification — an essential feature required by various device types. Although most major ecosystems do not yet support the configuration of Matter Groups, adding this functionality is a major step forward. This release includes complete support for groups on devices and bridges, along with basic functionalities for controllers. More convenient controller-side support for groups will be introduced in an upcoming release, so stay tuned.

Another major focus of this release is internal refactoring aimed at expanding support for JavaScript environments beyond Node.js. These changes include updates to our cryptography layer, which now functions in any modern JavaScript VM. As a result, we are proud to announce that matter.js now runs on Bun as a supported JavaScript runtime. We’re also evaluating additional JavaScript runtime engines and will share more updates in future releases.

Lastly, our Controller implementation has received a number of improvements, including support for non-concurrent commissioning flows and the ability to directly access cached attribute values.

This version also brings numerous stability and reliability enhancements to the Matter protocol stack.

Breaking Changes

Internal refactoring of the Crypto and Network layers has removed certain singleton classes. As a result, Crypto and Network must now be accessed through the environment, rather than as singletons.

Please refer to the full changelog below for more details.

Get Involved

Upgrade to matter.js 0.15 via npm, and share your feedback, experiences, or questions with us on GitHub or Discord—we’re here to support the community!

For a complete list of updates, see the Release Notes below.

Changelog

• @matter/*

  • Feature: Implement Matter Groups support in protocol, node and (partly) controller packages

• @matter/general

  • Breaking: The Network.get() singleton is removed
  • Breaking: The Crypto interface has changed; Crypto.get() singleton is removed, the API is modernized, methods are renamed for clarity, and the ecdh* methods are replaced with generateDhSecret
  • Feature: Adds a crypto implementation that should function in any modern JS VM
  • Enhancement: Adjust Dynamic class building approach to not use eval anymore to enable running in more environments
  • Fix: Fixes encoding of special IPv6 addresses in DNS-SD records

• @matter/model

  • (@FlyingNebulae) Fix: Allow aspectCache to also work when source got transpiled without keeping variable names

• @matter/node

  • Enhancement: Ensures behavior event interactionBegin to fire at the begin of an interaction as soon as the datasource is about to be changed on a behavior
  • Enhancement: Ensures behavior event interactionEnd to fire at the end of an interaction when all logic is done and executed
  • Enhancement: Ensures behavior event stateChanged to fire when an interaction changed the state of the behavior. It fires at the end after all concrete $Changed events are sent out
  • Fix: Ensures to remove all Fabric scoped data when a fabric is being removed
  • Fix: Streamline value conformance checks to cause a ConstraintError instead of an InvalidAction error in all cases

• @matter/protocol

  • Enhancement: Exposed reading cached ClusterClient attributes via get*AttributeFromCache() method
  • Enhancement: Enhances CSR content validation
  • Fix: Correctly handles Non-Concurrent Commissioning flows by skipping scanning for networks and use proper wait times for scan and connect calls for networks

• @matter/nodejs

  • Enhancement: New variables nodejs.crypto, nodejs.network and nodejs.storage allow users to enable/disable the implementation of these features that use Node.js APIs

• @matter/nodejs-ble

  • Fix: Removes Windows-specific workaround needed in older versions of Noble
  • Fix: Adjusts BLEScanner to allow cancellation of discovery processes when BLE is included

About matter.js

matter.js is an open-source JavaScript SDK that implements the Matter IoT standard, developed by the Connectivity Standards Alliance and its members. It simplifies the process of building Matter-compatible devices, bridges, and controllers.

Built on a Node.js-based architecture, matter.js runs on any operating system that supports Node.js—and now Bun as well. The included shell application allows developers to easily explore and interact with Matter devices during development and testing.

While still evolving toward full specification coverage, matter.js already supports key functionality. The first device built with it has been officially Matter-certified, with additional certifications underway.

Tens of thousands of users are already using matter.js in open-source (though uncertified) smart home projects, demonstrating interoperability with major ecosystems such as Amazon, Apple, Aqara, Google, and SmartThings.