PackageTrack
Sign in Get early access

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 2026
2019 2020 2021 2022 2023 2024 2025 2026
Release Pre-release

Releases

latest 31
  1. 0.20.0 15 Jun 2026
    Release notes

    What's Changed

    Full Changelog: v0.19.1...v0.20.0

    Open source →
  2. 0.19.1 19 May 2026
    Release notes

    What's Changed

    • Fix connection and subscription stability bugs by @FZambia in #109

    Full Changelog: v0.19.0...v0.19.1

    Open source →
  3. 0.19.0 10 May 2026
    Release notes

    What's Changed

    • Add Client.close() — disconnects and releases all client resources (closes every event stream and removes every subscription). The client is unusable after close(); subsequent public method calls throw ClientClosedError. Use Client.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 code 2502 (subscription state invalidated) now correctly clear the relevant token and recovery state, forcing a fresh getToken on 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 SubscribeRequest is in flight now sends a cleanup Unsubscribe to 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 to Subscribed.
      • Several smaller correctness fixes around connect-mutex resets, async error handling, ping-reply decoding, and the ClientDisconnectedError thrown type.
    • Wire ClientConfig.tlsSkipVerify through to the WebSocket transport on VM/Flutter (dart:io) platforms — was a silent no-op before. Useful for wss:// 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, getToken retries, and several race-condition tests, all running against the docker-compose Centrifugo.

    Full Changelog: v0.18.0...v0.19.0

    Open source →
  4. 0.18.0 02 Feb 2026
    Release notes

    What's Changed

    • Allow protobuf v6, drop Protobuf v3/v4, min SDK 3.7 by @FZambia in #104

    Full Changelog: v0.17.0...v0.18.0

    Open source →
  5. 0.17.0 12 Oct 2025
    Release notes

    What's Changed

    Full Changelog: v0.16.0...v0.17.0

    Open source →
  6. 0.16.0 08 Jul 2025
    Release notes

    What's Changed

    • Allow usage of protobuf v4, drop protobuf v2 by @FZambia in #100

    Full Changelog: v0.15.1...v0.16.0

    Open source →
  7. 0.15.1 29 May 2025
    Release notes

    What's Changed

    Full Changelog: v0.15.0...v0.15.1

    Open source →
  8. 0.15.0 26 Jan 2025
    Release notes

    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 setHeaders method to update headers #92.

    This release changes headers in ClientConfig from Map<String, dynamic> to Map<String, String>. This is a breaking change, but it must not cause huge troubles beyond a simple refactoring.

    Usages of dart.html were 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

    Open source →
  9. 0.14.1 02 Sep 2024
    Release notes

    What's Changed

    • Add renew connection data callback by @Holofox in #88

    Full Changelog: v0.14.0...v0.14.1

    Open source →
  10. 0.14.0 20 Jan 2024
    Release notes

    What's Changed

    • connInfo and chanInfo for join/leave events by @hetao29 #84

    New Contributors

    Full Changelog: v0.13.0...v0.14.0

    Open source →
  11. 0.13.0 18 Jan 2024

    Nothing published for this version

  12. 0.12.0 17 Jan 2024

    Nothing published for this version

  13. 0.11.0 19 Jul 2023

    Nothing published for this version

  14. 0.10.0 29 Jun 2023

    Nothing published for this version

  15. 0.9.4 21 May 2023

    Nothing published for this version

  16. 0.9.3 29 Jan 2023

    Nothing published for this version

  17. 0.9.2 16 Sep 2022

    Nothing published for this version

  18. 0.9.1 28 Jul 2022

    Nothing published for this version

  19. 0.9.0 20 Jul 2022

    Nothing published for this version

  20. 0.8.0 19 Nov 2021

    Nothing published for this version

  21. 0.7.1 11 Oct 2021

    Nothing published for this version

  22. 0.7.0 30 Aug 2021

    Nothing published for this version

  23. 0.6.0 05 Jul 2021

    Nothing published for this version

  24. 0.5.1 23 Apr 2020

    Nothing published for this version

  25. 0.5.0 03 Apr 2020

    Nothing published for this version

  26. 0.4.1 25 Feb 2020

    Nothing published for this version

  27. 0.4.0 15 Jul 2019

    Nothing published for this version

  28. 0.3.0 10 Jul 2019

    Nothing published for this version

  29. 0.2.0 27 Apr 2019

    Nothing published for this version

  30. 0.1.0 15 Sep 2018

    Nothing published for this version

  31. 0.0.1 24 Aug 2018

    Nothing published for this version

Every package, every release, already written down.

The archive is open and free. Watching your own project is what we are building next.

Browse the archive