NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #2028 most downloaded on pub.dev
Matrix Dart SDK
Latest stable
16.0.3
Last release 4 days ago
10 Nov 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 57 of the last 60 stable releases
2 versions withdrawn
withdrawn after publishing
12 years old
258 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
fix: deleting last message is edited (Mohammad Reza Moradi)
feat: endpoints for spec v1.14 (BREAKING CHANGE)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
chore: Export event localizations (Krille)
Now you can pass a StringBuffer object to the command handler to pass some arbitrary data back to the caller.
Now you can pass a StringBuffer object to the command handler to pass some arbitrary data back to the caller.
Before:
addCommand('newCommand', (CommandArgs args){});
After:
addCommand('newCommand', (CommandArgs args, StringBuffer? stdout){});
In order to use the stdout, you should create a StringBuffer stdout object and
pass it to the parseAndRunCommand method or sendTextEvent (that uses parseAndRunCommand internally).
Like this:
final stdout = StringBuffer();
await client.parseAndRunCommand(
null, // Room can be null now, if the command isn't room specific
"/newCommand options",
...
stdout: stdout,
);
// OR
await room.sendTextEvent(
"/newCommand options"
...
commandStdout: stdout,
);
final output = DefaultCommandOutput.fromStdout(stdout);
if(output != null) {
print(output.toString());
}
There are multiple breaking changes:
Bigger release with a lot of refactorings under the hood. Those do not necessarily make the SDK more performant but more robust and type safe.
There are multiple breaking changes:
dynamics to Object?Also Client.onEvent has been deprecated in favor of:
Client.onTimelineEvent // For timeline events (after decryption)
Client.onHistoryEvent // Same for timeline events when fetching history
Client.onNotification // Events which would trigger a notification like messages or room invites (after decryption)
If you are using Client.onEvent to filter for state events, please from now on use Client.onSync and filter the state events out of it (as they are unencrypted anyway). Same with "Account Data" or ephemeral events.
For notifications the usage should now be much easier as Client.onNotification already filters out events which should not
trigger a notification.
refactor: Do not set the deprecated dont_notify action in push rules (Krille)
Before:
Client('Name', onMigration: () {
print('Migrating now....');
});
After:
Client('Name', onInitStateChanged: (state) {
if (state == InitState.migratingDatabase) {
print('Migrating now....');
}
});
Fixes a minor performance leak where the app re-requests the member list of all encrypted rooms. For this the parameter cache in Room.requestParticipa
Fixes a minor performance leak where the app re-requests the member list of all encrypted rooms.
For this the parameter cache in Room.requestParticipants() is now also
responsible to store the member data in the database. Also it is not true by default anymore for
unencrypted rooms.
feat: add equality and hashCode overrides for autogenerated models (BREAKING CHANGE) (td)
feat: BREAKING CHANGE v1.11 matrix-spec endpoints (td)
fix: actually make sure clientBox has a account (td)
feat: cache .well-known data (The one with the braid)
fix: SQLCipher dylib location on macOS builds (The one with the braid)
feat: support for authenticated media (td)
chore: add info about tests to readme (td)
Nothing published for this version
ci: create release job fix (Karthikeyan S)
feat: Automatically cancel typing indicators after 30 seconds (Krille)
chore: allow clients to set their own voip key delays (td)
fix: Request user causing state update loops for apps (Nicolas Werner)
chore: make ignored call mem logging verbose (td)
chore: bump make and use key delays to have more buffer (td)
refactor: Deprecate Streams in favor of client.onSync (krille-chan)
fix: make sure room is postLoaded before starting calls (td)
fix: nonLocal join/left values (td)
feat: hide \_makeNewSenderKey and expose a new preShareKey function (td)
feat: make voip key generator public (td)
fix: Hotfix create missing objectbox (Krille)
chore: add MatrixSDKVoipException and some more logging (td)
feat: Implement unpublished MSC custom refresh token lifetime (Krille)
chore: Revert check message size before fake sync (Krille)
Refactoring release which fixes a flickering of sent file events in the timeline. The State events in a room are no longer instances of Event but Stri
Refactoring release which fixes a flickering of sent file events in the timeline. The
State events in a room are no longer instances of Event but StrippedStateEvent by
default, which is a base class of Event. Usually in join rooms the state events are
actually Event and can be used as those after a type check if needed.
Example:
// Before:
final event = room.getState(EventTypes.RoomCreate);
// After:
final strippedStateEvent = room.getState(EventTypes.RoomCreate);
final event = strippedStateEvent is Event ? strippedStateEvent : null;
Also be aware that Event.remove() has been renamed to Event.cancelSend() to make
more clear that this is only to delete events from database and cache which have not
been synced yet. They no longer appear in the Client.onEventUpdate stream but on the new
Client.onCancelSendEvent stream.
chore: expose fake matrix api (td)
This release introduces the new famedly calls, it brings 1:1, mesh and livekit calls support to the matrix dart sdk, read more at: voip docs
This release introduces the new famedly calls, it brings 1:1, mesh and livekit calls support to the matrix dart sdk, read more at: voip docs
refactor: Switch to MatrixSdkDatabase as suggested database and deprecate other ones
chore: add noice/echo cancelling flags to getUserMedia (td)
This release adds a new state to the LoginState named softLoggedOut. Learn more about it here: https://spec.matrix.org/v1.9/client-server-api/#soft-lo
This release adds a new state to the LoginState named softLoggedOut. Learn more about it here:
https://spec.matrix.org/v1.9/client-server-api/#soft-logout
When a client is in a soft logout state, it is not yet cleared, but sync has stopped and it expects to perform a token refresh or a new login while providing the old device ID.
chore: Add regression test for invite->join state handling (Nicolas Werner)
refactor: Deprecations after dart upgrade (Krille)
feat: Implement handling soft logout (Krille)
chore: remove state events both in imp and preview events list (td)
fix: group calls terminator having sync glares (td)
chore: Use some call events as last events (Krille)
feat: add SQfLite encryption helper (The one with the braid)
feat: Add missing localizations for key verification messages (Krille)
fix: Another type error when combining lists (Krille)
fix: Type error when combining dynamic lists (Krille)
fix: Delete in transaction on new store does not clear cache correctly (Krille)
fix: Add missing copy map in matrix sdk database (Krille)
ci: Test that database can write and read at least 5mb of data (Krille)
feat: cache getConfig request (Karthikeyan S)
Small hotfix for the new database.
Small hotfix for the new database.
docs: Add issue tracker to pub.dev (Krille)
This release brings a new experimental database based on SQFlite and IndexedDB as a _Drop-In-Replacement_ for Hive and HiveCollections. You can alread
This release brings a new experimental database based on SQFlite and IndexedDB as a Drop-In-Replacement for Hive and HiveCollections. You can already test it out (on your own risk) by using it as the new databaseBuilder and migrate your current users by using the legacyDatabaseBuilder with your current Database:
final client = Client('Client Name',
databaseBuilder: (client) => MatrixSdkDatabase(
'Database Name',
database: await databaseFactory.openDatabase(':memory:'),
),
legacyDatabaseBuilder: yourPreviousDatabase,
);
Breaking change for users of dehydrated devices feature. This feature now implements the latest version of the MSC. It has been adapted to the current…
This release deprecates client.presences in favor of client.fetchCurrentPresence(userId) as part of our journey to a more database centric memory management. However, client.presences is still functional and tested at least until the next major release.
Breaking change for users of dehydrated devices feature. This feature now implements the latest version of the MSC. It has been adapted to the current recent Synapse version and will from now on be incompatible with previous versions.
This release includes a small breaking change. Starting a verification request now always returns a future. Specifically this changes the DeviceKeys s…
This release includes a small breaking change. Starting a verification request now always returns a future. Specifically this changes the DeviceKeys startVerification method to also return a future.
Additionally this release fixes a severe regression in the online key backup (keys only got uploaded once after startup or before logout), excessive linebreaks in markdown messages and a few edge cases around when presence is sent.
chore: incrementally add left rooms to archive (The one with the braid)
fix: Do not convert linebreaks in pre blocks on markdown parsing (Krille)
build(deps): bump http from 0.13.6 to 1.1.0 (dependabot[bot])
refactor: Remove deprecated dart code metrics (Krille)
feat: Add option to not cache users in memory when requesting all of a room (krille-chan)
One column per quarter.