NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #382 most downloaded on pub.dev
Listens to changes in a PostgreSQL Database and via websockets. This is for usage with Supabase Realtime server.
Latest stable
2.13.2
Last release 1 months ago
12 Oct 2026
Ships fairly regularly
a new release about every 6 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
85 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
FIX (realtime_client): keep a rejoining channel from unsubscribing itself ( #1950 ).
Published to pub.dev: https://pub.dev/packages/realtime_client/versions/2.13.2
FIX (realtime): resend joins with a fresh ref and remove only the given channel ( #1933 ).
Published to pub.dev: https://pub.dev/packages/realtime_client/versions/2.13.1
Your coding agent can read these notes before it upgrades. Set up the MCP server →
REFACTOR(supabase_common): share the local stack test configuration (#1640).
Published to pub.dev: https://pub.dev/packages/realtime_client/versions/2.13.0
FEAT(realtime_client): support new postgres changes filter operators, multi-filter, column selection, and replication-ready events (#1526).
FIX(realtime): preserve nested empty maps in Message.toJson() (#1518).
in filter values (#1506). (30349e22)Published to pub.dev: https://pub.dev/packages/realtime_client/versions/2.10.0
FIX(realtime): cancel pending reconnect on disconnect after a dropped socket (#1477).
REFACTOR(realtime_client): extract broadcast headers and body builders (#1461).
Published to pub.dev: https://pub.dev/packages/realtime_client/versions/2.9.0
FIX: raise min Dart SDK to 3.4.0 across all packages (#1409).
FIX(realtime_client): suppress InvalidJWTToken from setAuth in joinPush 'ok' handler (#1365).
FIX(postgrest): escape quotes and backslashes in list filter values (#1481).
FIX(postgrest): include caller frames in PostgrestException stack traces (#1387).
REFACTOR: extract shared code into supabase_common package (#1573).
FEAT(storage): add download option to signed and public URLs (#1514).
FIX(storage): avoid duplicate Content-Type headers and header mutation (#1359).
FIX(types): improve JSON decoding resilience (#1301).
FIX(storage): make dedicated storage host opt-in via useNewHostname flag (#1329).
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
gotrue - v2.18.0postgrest - v2.6.0realtime_client - v2.7.0supabase_flutter - v2.12.0supabase - v2.10.2Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
supabase - v2.10.2FIX: FunctionException implements Exception (#1134).
REFACTOR: Remove unnecessary parentheses in Bucket.fromJson (#1201).
FEAT(storage_client): Custom-metadata, exists, info methods (#1023).
FEAT: Support mime 2.0.0 (#1079).
FIX: Upgrade web_socket_channel for supporting web: ^1.0.0 and therefore WASM compilation on web (#992).
- FEAT: Add logging (#1042).
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
functions_client - v2.4.1realtime_client - v2.4.2storage_client - v2.3.1supabase - v2.6.3supabase_flutter - v2.8.4Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
functions_client - v2.3.2gotrue - v2.8.4postgrest - v2.1.4realtime_client - v2.2.1storage_client - v2.0.3supabase - v2.3.0supabase_flutter - v2.6.0yet_another_json_isolate - v2.0.2Packages with breaking changes:
web_socket_channel for supporting web: ^1.0.0 and therefore WASM compilation on web (#992). (7da68565)Packages with breaking changes:
Packages with other changes:
yet_another_json_isolate - v2.0.1postgrest - v2.1.3functions_client - v2.3.1supabase - v2.2.7supabase_flutter - v2.5.11Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
postgrest - v2.1.3functions_client - v2.3.1supabase - v2.2.7supabase_flutter - v2.5.11Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
supabase - v2.2.6supabase_flutter - v2.5.10Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
BREAKING FEAT(realtime_client): Introduce type safe realtime methods (#725).
FIX: PKCE flow not emitting password recovery event (#744).
FIX: issue where .range() not respecting the offset given. (#722).
FIX(functions_client): use header for response parsing (#616).
FIX: make Supabase client work in Dart Edge again (#675).
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
supabase - v1.11.6supabase_flutter - v1.10.19Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
supabase_flutter - v1.10.18Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
supabase - v1.11.3supabase_flutter - v1.10.16FIX(realtime_client,supabase): pass apikey as the initial access token for realtime client (#596).
FEAT: add logLevel parameter to RealtimeClientOptions (#592).
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
gotrue - v1.11.1postgrest - v1.4.0realtime_client - v1.1.2supabase - v1.9.8supabase_flutter - v1.10.10Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
supabase_flutter - v1.10.10FIX(realtime_client): correct channel error data (#566).
REFACTOR: bump minimum Dart SDK version to 2.17.0 (#510).
FIX: Format the files to adjust to Flutter 3.10.1 (#475).
chore: move the repo into supabase-flutter monorepo
- fix: catch SocketException #62
SocketException #62fix: export realtime presence #60
fix: bug where leaving existing topic throws #58
fix: set minimum Dart SDK to 2.14.0 #56
fix: sends null for access_token when not signed in #53
fix: bug where it throws exception when listening to postgres changes on old version of realtime server
BREAKING: fix payload shape on old version of realtime server to match the new version
fix: bug where presence sync of other clients causes exception
feat: add support for broadcast and presence
.on() no longer takes a event string (e.g. INSERT, UPDATE or DELETE), but takes RealtimeListenTypes and a ChannelFilterfinal socket = RealtimeClient('ws://SUPABASE_API_ENDPOINT/realtime/v1');
final channel = socket.channel('can_be_any_string');
// listen to insert events on public.messages table
channel.on(
RealtimeListenTypes.postgresChanges,
ChannelFilter(
event: 'INSERT',
schema: 'public',
table: 'messages',
), (payload, [ref]) {
print('database insert payload: $payload');
});
// listen to `location` broadcast events
channel.on(
RealtimeListenTypes.broadcast,
ChannelFilter(
event: 'location',
), (payload, [ref]) {
print(payload);
});
// send `location` broadcast events
channel.send(
type: RealtimeListenTypes.broadcast,
event: 'location',
payload: {'lat': 1.3521, 'lng': 103.8198},
);
// listen to presence states
channel.on(RealtimeListenTypes.presence, ChannelFilter(event: 'sync'),
(payload, [ref]) {
print(payload);
print(channel.presenceState());
});
// subscribe to the above changes
channel.subscribe((status) async {
if (status == 'SUBSCRIBED') {
// if subscribed successfully, send presence event
final status = await channel.track({'user_id': myUserId});
}
});
fix: use toString() instead of type cast error response
fix: allow null access token to be passed
- fix: number transformers
feat: add setAuth to send user Access Token to Realtime Server
feat: update transformers to accept already transformed walrus changes
fix: parsing bug of boolean values on WALRUS
chore: added X-Client-Info header
One column per quarter.