centrifuge
Dart client to communicate with Centrifuge and Centrifugo from Flutter and VM over WebSockets
0.20.0
42K downloads/mo
#1585 most downloaded on pub.dev
centrifugal/centrifuge-dart
What this package is like to depend on
Last release 2 months ago
15 Jun 2026
Ships fairly regularly
a new release about every 3 months
Some releases are documented
notes for 10 of 31 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
31 releases · first in 2018
5 releases in the last 12 months
see the full history below
Release timeline
31 releases · Aug 2018 to Jun 2026Releases
latest 31-
0.20.015 Jun 2026Release notes
Open source →What's Changed
- Support getState callback by @FZambia in #110
- Support channel compaction by @FZambia in #111
- Support publication filtering by tags by @FZambia in #112
- Resubscribe from an unrecoverable position on state invalidation by @FZambia in #113
Full Changelog: v0.19.1...v0.20.0
-
0.19.119 May 2026 -
0.19.010 May 2026Release notes
Open source →What's Changed
- Add
Client.close()— disconnects and releases all client resources (closes every event stream and removes every subscription). The client is unusable afterclose(); subsequent public method calls throwClientClosedError. UseClient.disconnect()for a temporary disconnect that keeps the client usable. #106 - Multiple connection stability fixes, see #106 for the full list. Highlights:
await client.disconnect()now actually waits for transport teardown before resolving.- Disconnect code
3014(connection state invalidated) and unsubscribe code2502(subscription state invalidated) now correctly clear the relevant token and recovery state, forcing a freshgetTokenon reconnect. - WebSocket close code
1009(message size limit) is now terminal (no auto-reconnect), matching the behavior in centrifuge-js. - Cancelling a subscription while its
SubscribeRequestis in flight now sends a cleanupUnsubscribeto the server, preventing a "ghost" server-side subscription that keeps pushing publications to the local sub. - Concurrent
unsubscribe()/disconnect during a subscribe round-trip can no longer flip the subscription state back toSubscribed. - Several smaller correctness fixes around connect-mutex resets, async error handling, ping-reply decoding, and the
ClientDisconnectedErrorthrown type.
- Wire
ClientConfig.tlsSkipVerifythrough to the WebSocket transport on VM/Flutter (dart:io) platforms — was a silent no-op before. Useful forwss://development against a self-signed cert. Web platforms ignore the flag, since the browser owns TLS validation. #107 - Substantially expand the integration test suite: server-initiated reconnection scenarios, extended stream recovery edge cases, client/subscription lifecycle ordering,
getTokenretries, and several race-condition tests, all running against the docker-compose Centrifugo.
Full Changelog: v0.18.0...v0.19.0
- Add
-
0.18.002 Feb 2026 -
0.17.012 Oct 2025Release notes
Open source → -
0.16.008 Jul 2025 -
0.15.129 May 2025 -
0.15.026 Jan 2025Release notes
Open source →What's Changed
- Update
web_socket_channel, min Dart SDK is now 3.3 #91 - Support headers emulation in web context - so it's possible to pass custom connection headers to the backend when using Centrifugo v6 and connect proxy. Also added
setHeadersmethod to update headers #92.
This release changes
headersinClientConfigfromMap<String, dynamic>toMap<String, String>. This is a breaking change, but it must not cause huge troubles beyond a simple refactoring.Usages of
dart.htmlwere removed in this release. Also some internal optimizations were done to allocate less when constructing Protobuf command data.Full Changelog: v0.14.1...v0.15.0
- Update
-
0.14.102 Sep 2024 -
0.14.020 Jan 2024 -
0.13.018 Jan 2024Nothing published for this version
-
0.12.017 Jan 2024Nothing published for this version
-
0.11.019 Jul 2023Nothing published for this version
-
0.10.029 Jun 2023Nothing published for this version
-
0.9.421 May 2023Nothing published for this version
-
0.9.329 Jan 2023Nothing published for this version
-
0.9.216 Sep 2022Nothing published for this version
-
0.9.128 Jul 2022Nothing published for this version
-
0.9.020 Jul 2022Nothing published for this version
-
0.8.019 Nov 2021Nothing published for this version
-
0.7.111 Oct 2021Nothing published for this version
-
0.7.030 Aug 2021Nothing published for this version
-
0.6.005 Jul 2021Nothing published for this version
-
0.5.123 Apr 2020Nothing published for this version
-
0.5.003 Apr 2020Nothing published for this version
-
0.4.125 Feb 2020Nothing published for this version
-
0.4.015 Jul 2019Nothing published for this version
-
0.3.010 Jul 2019Nothing published for this version
-
0.2.027 Apr 2019Nothing published for this version
-
0.1.015 Sep 2018Nothing published for this version
-
0.0.124 Aug 2018Nothing published for this version