Release 0.14.0 from 05.06.2025 #2112
Apollon77
announced in
Announcements
Replies: 1 comment
-
Thanks for your incredible work. We all appreciate it! The optimization of memory requirements on large bridges is impressive. |
Beta Was this translation helpful? Give feedback.
0 replies
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
-
matter.js 0.14.0 – Matter 1.4.1 and More
We’re excited to announce the release of version 0.14 of matter.js, the Matter JavaScript SDK!
What’s New in Version 0.14
This release primarily focuses on upgrading support to Matter version 1.4.1, along with improvements in memory and CPU efficiency.
matter.js v0.14 now supports all new device types, clusters, and data types introduced in the Matter 1.4.1 specification, enabling the development of Matter-compatible devices, bridges, and controllers. With this update, matter.js supports the new Matter version just one month after the official specification release.
We’ve also continued internal refactoring, re-implemented the entire interaction logic for Devices and Bridges, and made further optimizations to the MDNS implementation. The operational Matter Model in devices has been optimized to load metadata—such as specification references and text—only when needed. These changes result in over 10% lower RAM usage and up to 30% lower CPU usage, for example during a full wildcard subscribe.
The Controller implementation and API have also been improved, with a particular focus on delivering more detailed user feedback in commissioning error scenarios.
The matter.sh Shell app has been enhanced through a user contribution with a WebSocket interface, allowing shell commands to be used within a browser page while the backend runs on a Node.js-compatible server. An example implementation is included, showcasing paired devices as interactive tiles using data returned from the shell.
This version also brings numerous stability and reliability improvements to the Matter protocol stack.
Looking ahead, our focus will shift toward expanding support for remaining Matter protocol features, introducing a new Controller API, and broadening platform compatibility for matter.js. Stay tuned—more is on the way!
Breaking Changes
Support for Matter 1.4.1 introduces minimal breaking changes, as the update primarily promotes existing features, clusters, and device types from provisional to officially supported status.
The optimization of the matter.js Matter Model, which now separates out specification metadata, does require an additional import in your code when these details are needed—for example, for custom code generation use cases.
Please refer to the full Changelog below for all details.
Get Involved
Update to matter.js 0.14 on npm, and share your feedback, experiences, and questions with us on GitHub or Discord—we’re here to support you!
For a complete list of changes, see the Release Notes below.
Changelog
NOTE: This version is compatible with Node.js 20.x, 22.x and 24.x. Node.js 18.x is also supported with the following exceptions:
@matter/*
@matter/general
@matter/node
endpointProtocol
property on EndpointTransitions.applyUpdates()
correctly in all cases to prevent dangling promisesundefined
for optional nullable attributes@matter/nodejs-ble
@matter/nodejs-shell
@matter/protocol
logEndpoint()
and alsoEndpointServer
class was removed. The Endpoints support logging directly via DiagnosticsgetLocal()
to AttributeClient to retrieve the currently stored/cached valueCommissioningError
to allow distinguishing between different error cases more easily:@matter/general
@matter/model
@matter/model/resources
to populate the model with these fields. This saves a significant amount of memory for nodestitle
field to capture the full name of features@project-chip/matter.js
PairedNode
and legacyEndpoint
classes viaDiagnostics
instead of the removedlogEndpoint
methodAbout matter.js
matter.js is an open-source project that provides a JavaScript SDK implementing 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 OS that supports Node.js.
The included shell application makes it easy to explore and interact with Matter devices during development and testing. While the project is still evolving toward full specification coverage, matter.js already supports key functionalities—and the first device built with it has been officially certified, with more certifications in progress.
Tens of thousands of users are already using matter.js in various (uncertified) open-source smart home projects, demonstrating interoperability with major ecosystems such as Amazon, Apple, Aqara, Google, and SmartThings.
Beta Was this translation helpful? Give feedback.
All reactions