NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #363 most downloaded on pub.dev
A dart client for Supabase. This client makes it simple for developers to build secure and scalable products.
Last release 2 days ago
06 Oct 2026
Release timing varies
gaps range from 8 days to 2 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
6 years old
175 releases · first in 2021
One column per quarter.
Note: This release has breaking changes.
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase/versions/3.0.0-dev.9
Published to pub.dev: https://pub.dev/packages/supabase_flutter/versions/3.0.0-dev.9
Note: This release has breaking changes.
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_realtime/versions/3.0.0-dev.8
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_flutter/versions/3.0.0-dev.8
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase/versions/3.0.0-dev.8
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_auth/versions/3.0.0-dev.8
REFACTOR : define shared HTTP header names in supabase_common ( #1917 ).
Published to pub.dev: https://pub.dev/packages/supabase_functions/versions/3.0.0-dev.7
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_storage/versions/3.0.0-dev.7
Published to pub.dev: https://pub.dev/packages/supabase_realtime/versions/3.0.0-dev.7
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/postgrest/versions/3.0.0-dev.7
Published to pub.dev: https://pub.dev/packages/supabase/versions/3.0.0-dev.7
FIX (functions): decode response bodies that are not valid UTF-8 instead of throwing ( #1892 ).
Published to pub.dev: https://pub.dev/packages/supabase_functions/versions/3.0.0-dev.6
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_auth/versions/3.0.0-dev.6
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_flutter/versions/3.0.0-dev.6
Published to pub.dev: https://pub.dev/packages/supabase_realtime/versions/3.0.0-dev.6
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase/versions/3.0.0-dev.6
Published to pub.dev: https://pub.dev/packages/supabase_common/versions/3.0.0-dev.6
REFACTOR : prune redundant comments that restate the code below them ( #1852 ).
Published to pub.dev: https://pub.dev/packages/supabase_functions/versions/3.0.0-dev.5
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_flutter/versions/3.0.0-dev.5
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_auth/versions/3.0.0-dev.5
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/postgrest/versions/3.0.0-dev.5
Note: This release has breaking changes.
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_common/versions/3.0.0-dev.4
Published to pub.dev: https://pub.dev/packages/supabase_auth/versions/3.0.0-dev.4
Published to pub.dev: https://pub.dev/packages/supabase_flutter/versions/3.0.0-dev.4
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_storage/versions/3.0.0-dev.4
Note: This release has breaking changes.
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_common/versions/3.0.0-dev.3
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_auth/versions/3.0.0-dev.3
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_flutter/versions/3.0.0-dev.3
Published to pub.dev: https://pub.dev/packages/supabase_functions/versions/3.0.0-dev.3
Published to pub.dev: https://pub.dev/packages/supabase_realtime/versions/3.0.0-dev.3
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase/versions/3.0.0-dev.3
Note: This release has breaking changes.
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_common/versions/3.0.0-dev.2
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_realtime/versions/3.0.0-dev.2
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_storage/versions/3.0.0-dev.2
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_auth/versions/3.0.0-dev.2
Published to pub.dev: https://pub.dev/packages/supabase_flutter/versions/3.0.0-dev.2
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_functions/versions/3.0.0-dev.2
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase/versions/3.0.0-dev.2
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/yet_another_json_isolate/versions/3.0.0-dev.2
Pre-release versioning run for the v3 train. Every published SDK package lands on 3.0.0-dev.1 so the whole set can go to pub.dev as a coherent prerele
Pre-release versioning run for the v3 train. Every published SDK package
lands on 3.0.0-dev.1 so the whole set can go to pub.dev as a coherent
prerelease.
| Package | Before | After |
|---|---|---|
supabase_common |
0.1.2 | 3.0.0-dev.1 |
postgrest |
2.9.1 | 3.0.0-dev.1 |
supabase_auth |
3.0.0-dev.1 | 3.0.0-dev.1 |
supabase_functions |
3.0.0-dev.1 | 3.0.0-dev.1 |
supabase_realtime |
3.0.0-dev.1 | 3.0.0-dev.1 |
supabase_storage |
3.0.0-dev.1 | 3.0.0-dev.1 |
supabase |
2.16.0 | 3.0.0-dev.1 |
supabase_flutter |
2.17.1 | 3.0.0-dev.1 |
supabase_auth, supabase_functions, supabase_realtime and
supabase_storage already carried 3.0.0-dev.1 in their pubspec, but
that number was hand-set during the package renames and never published,
so no matching changelog section existed. This run generates it and
leaves the version where it is.
iceberg stays on 0.1.0. It has never been published, so its
accumulated changes are folded into the existing ## 0.1.0 changelog
section instead of opening a new one. supabase_storage keeps its
iceberg: 0.1.0 constraint.
yet_another_json_isolate stays on 2.1.1supabase_testing stays on 0.1.0supabase_lints and supabase_typegen stay on 0.1.1, they version onTheir pubspec versions and changelogs are untouched, as are the
constraints pointing at them (yet_another_json_isolate: 2.1.1,
supabase_lints: ^0.1.1).
pubspec.yaml versions plus the intra-workspace dependencylib/src/version.dart for postgrest, supabase andsupabase_flutter, regenerated by the update-version melos hookCHANGELOG.md and the workspace CHANGELOG.mdsupabase_flutter: ^3.0.0-dev.1 and supabase: ^3.0.0-dev.1 in themelos version with an explicit --manual-version entry for every
package that had versionable commits, so nothing was auto-bumped by
conventional-commit inference. Packages held back from the release were
passed their current version to stop melos auto-versioning them, and the
resulting no-op changelog sections were dropped again.
flutter pub get resolves the workspace, pubspec.lock needs nodart analyze --fatal-infos reports no issuesTagging and publishing are left to release-tag.yml and
release-publish.yml once this merges.
New Features
Introduced the Supabase Flutter v3.0.0-dev.1 release, including
improved realtime streams, asynchronous codecs, per-flow PKCE storage,
unified retry configuration, and enhanced JSON performance.
Added shared testing utilities and the new supabase_testing package.
Bug Fixes
Improved authentication redirect and session parsing, access-token
handling, storage behavior, and resource disposal.
Documentation
Added comprehensive changelogs, breaking-change notes, and a v2-to-v3
migration guide.
Note: This release has breaking changes.
Update a dependency to the latest release.
Published to pub.dev: https://pub.dev/packages/supabase/versions/2.16.2
Update a dependency to the latest release.
Published to pub.dev: https://pub.dev/packages/supabase/versions/2.16.1
REFACTOR (supabase_common): share the local stack test configuration ( #1640 ).
Published to pub.dev: https://pub.dev/packages/supabase/versions/2.16.0
FEAT(realtime_client): support new postgres changes filter operators, multi-filter, column selection, and replication-ready events (#1526).
Update a dependency to the latest release.
Update a dependency to the latest release.
Update a dependency to the latest release.
REFACTOR: de-abbreviate cond* platform getters to conditional* (#1438).
REFACTOR (supabase_common): share the local stack test configuration ( #1640 ).
Published to pub.dev: https://pub.dev/packages/realtime_client/versions/2.13.0
Update a dependency to the latest release.
Update a dependency to the latest release.
REFACTOR: modernize dart syntax across client packages (#1574).
FIX(realtime): prevent null check crash in connect() during rapid lifecycle transitions (#1321).
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
gotrue - v2.19.0realtime_client - v2.7.1storage_client - v2.5.0supabase - v2.10.3supabase_flutter - v2.12.1Packages 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.3supabase_flutter - v2.12.1Packages 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.9.2supabase_flutter - v2.10.2Update a dependency to the latest release.
FIX(realtime): preserve nested empty maps in Message.toJson() (#1518).
Update a dependency to the latest release.
REFACTOR (supabase_common): share the local stack test configuration ( #1640 ).
Published to pub.dev: https://pub.dev/packages/postgrest/versions/2.9.1
REFACTOR: modernize dart syntax across client packages (#1574).
REFACTOR (supabase_common): share the local stack test configuration ( #1640 ).
Published to pub.dev: https://pub.dev/packages/storage_client/versions/2.8.0
REFACTOR: extract shared code into supabase_common package (#1573).
FIX(functions): drain error responses with a streaming content type (#1480).
FIX(functions_client): use case-insensitive check for Content-Type header in invoke() (#1486).
FIX: raise min Dart SDK to 3.4.0 across all packages (#1409).
FEAT(storage): add download option to signed and public URLs (#1514).
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.2FEAT(storage_client): Custom-metadata, exists, info methods (#1023).
FEAT: Support mime 2.0.0 (#1079).
Update a dependency to the latest release.
Update a dependency to the latest release.
FIX: Add error messages for when the session or expiresAt was missing while making API requests. (#976).
Update a dependency to the latest release.
Update a dependency to the latest release.
Update a dependency to the latest release.
FIX: Upgrade web_socket_channel for supporting web: ^1.0.0 and therefore WASM compilation on web (#992).
- FEAT: Add logging (#1042).
Update a dependency to the latest release.
FIX(postgrest): Update parameter type of isFilter() to only allow boolean or null (#920).
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
postgrest - v2.7.1realtime_client - v2.7.4storage_client - v2.5.6supabase_flutter - v2.14.2supabase - v2.12.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.12.2Packages 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.4Update a dependency to the latest release.
REFACTOR: Deprecate eventsPerSecond on Realtime (#838).
Update a dependency to the latest release.
Update a dependency to the latest release.
Update a dependency to the latest release.
Packages 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:
Your coding agent can read these notes before it upgrades. Set up the MCP server →