NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #385 most downloaded on pub.dev
Flutter integration for Supabase. This package makes it simple for developers to build secure and scalable products.
Latest stable
2.18.3
Last release 5 days ago
17 Nov 2026
Ships fairly regularly
a new release about every 9 days
Nearly every release is documented
notes for 60 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
5 years old
167 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
Note: This release has breaking changes.
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_flutter/versions/3.0.0-dev.18
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase/versions/3.0.0-dev.18
Note: This release has breaking changes.
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/postgrest/versions/3.0.0-dev.17
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_flutter/versions/3.0.0-dev.17
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.16
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/postgrest/versions/3.0.0-dev.16
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_flutter/versions/3.0.0-dev.16
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase/versions/3.0.0-dev.16
Note: This release has breaking changes.
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_auth/versions/3.0.0-dev.15
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_storage/versions/3.0.0-dev.15
Published to pub.dev: https://pub.dev/packages/supabase_realtime/versions/3.0.0-dev.15
Published to pub.dev: https://pub.dev/packages/supabase_flutter/versions/3.0.0-dev.15
Published to pub.dev: https://pub.dev/packages/supabase/versions/3.0.0-dev.15
FEAT (postgrest): filter inside an embed, add requiring and relation isNull on the typed surface ( #2061 ).
Published to pub.dev: https://pub.dev/packages/supabase_flutter/versions/3.0.0-dev.14
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_storage/versions/3.0.0-dev.14
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_auth/versions/3.0.0-dev.14
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_realtime/versions/3.0.0-dev.14
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase/versions/3.0.0-dev.14
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/postgrest/versions/3.0.0-dev.14
Note: This release has breaking changes.
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_functions/versions/3.0.0-dev.13
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_storage/versions/3.0.0-dev.13
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_auth/versions/3.0.0-dev.13
Published to pub.dev: https://pub.dev/packages/supabase_realtime/versions/3.0.0-dev.13
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase/versions/3.0.0-dev.13
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_flutter/versions/3.0.0-dev.13
Note: This release has breaking changes.
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_auth/versions/3.0.0-dev.12
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_realtime/versions/3.0.0-dev.12
Published to pub.dev: https://pub.dev/packages/supabase_functions/versions/3.0.0-dev.12
Published to pub.dev: https://pub.dev/packages/supabase_storage/versions/3.0.0-dev.12
Published to pub.dev: https://pub.dev/packages/supabase_flutter/versions/3.0.0-dev.12
Published to pub.dev: https://pub.dev/packages/supabase/versions/3.0.0-dev.12
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.11
Published to pub.dev: https://pub.dev/packages/supabase_functions/versions/3.0.0-dev.11
Published to pub.dev: https://pub.dev/packages/supabase_storage/versions/3.0.0-dev.11
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_realtime/versions/3.0.0-dev.11
Published to pub.dev: https://pub.dev/packages/supabase_flutter/versions/3.0.0-dev.11
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase/versions/3.0.0-dev.11
REFACTOR : name the description argument of jsonObject and jsonObjectList ( #2097 ).
Published to pub.dev: https://pub.dev/packages/supabase_common/versions/3.0.0-dev.10
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_functions/versions/3.0.0-dev.10
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_storage/versions/3.0.0-dev.10
Published to pub.dev: https://pub.dev/packages/supabase_realtime/versions/3.0.0-dev.10
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_flutter/versions/3.0.0-dev.10
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase/versions/3.0.0-dev.10
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
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_common/versions/3.0.0-dev.9
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_functions/versions/3.0.0-dev.9
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_storage/versions/3.0.0-dev.9
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_auth/versions/3.0.0-dev.9
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_realtime/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_auth/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_functions/versions/3.0.0-dev.8
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_storage/versions/3.0.0-dev.8
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_realtime/versions/3.0.0-dev.8
Update a dependency to the latest release.
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
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_common/versions/3.0.0-dev.7
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
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/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_flutter/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
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_storage/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.
Published to pub.dev: https://pub.dev/packages/supabase_flutter/versions/3.0.0-dev.5
Update a dependency to the latest release.
Published to pub.dev: https://pub.dev/packages/supabase/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
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_common/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/versions/3.0.0-dev.3
Published to pub.dev: https://pub.dev/packages/supabase_storage/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_flutter/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_common/versions/3.0.0-dev.3
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/yet_another_json_isolate/versions/3.0.0-dev.3
Packages with breaking changes:
Packages with other changes:
postgrest - v3.0.0-dev.12supabase - v3.0.0-dev.12supabase_test - v0.5.2supabase_flutter - v3.0.0-dev.12supabase_flutter_web_auth - v0.1.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 - v3.0.0-dev.12supabase_flutter_web_auth - v0.1.10Note: This release has breaking changes.
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/yet_another_json_isolate/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/supabase_functions/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_auth/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_realtime/versions/3.0.0-dev.2
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_common/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_flutter/versions/2.18.3
Update a dependency to the latest release.
Published to pub.dev: https://pub.dev/packages/supabase_flutter/versions/2.18.2
Update a dependency to the latest release.
Published to pub.dev: https://pub.dev/packages/supabase_flutter/versions/2.18.1
FEAT (supabase_flutter): add RealtimeLifecycleOptions to delay or skip the realtime disconnect on pause ( #1900 ).
Published to pub.dev: https://pub.dev/packages/supabase_flutter/versions/2.18.0
Update a dependency to the latest release.
Published to pub.dev: https://pub.dev/packages/supabase_flutter/versions/2.17.2
Update a dependency to the latest release.
Published to pub.dev: https://pub.dev/packages/supabase_flutter/versions/2.17.1
REFACTOR (supabase_common): share the local stack test configuration ( #1640 ).
Published to pub.dev: https://pub.dev/packages/supabase/versions/2.16.0
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
gotrue - v2.24.0postgrest - v2.7.4realtime_client - v2.9.1supabase_flutter - v2.15.3supabase - v2.13.3Packages 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.13.3Packages 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.13.2Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
functions_client - v2.6.2gotrue - v2.23.0postgrest - v2.7.3realtime_client - v2.9.0storage_client - v2.5.8supabase - v2.13.1supabase_flutter - v2.15.1Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
functions_client - v2.6.1gotrue - v2.22.0postgrest - v2.7.2realtime_client - v2.8.0storage_client - v2.5.7supabase - v2.13.0supabase_flutter - v2.15.0yet_another_json_isolate - v2.1.1REFACTOR(supabase): convert private stream-builder holders to records (#1575).
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 - v2.12.1supabase_flutter - v2.14.1Update a dependency to the latest release.
FEAT(realtime_client): support new postgres changes filter operators, multi-filter, column selection, and replication-ready events (#1526).
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
Update a dependency to the latest release.
Update a dependency to the latest release.
REFACTOR: modernize dart syntax across client packages (#1574).
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 - v2.9.2supabase_flutter - v2.10.2Update a dependency to the latest release.
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
functions_client - v2.4.4gotrue - v2.14.0realtime_client - v2.5.2storage_client - v2.4.1supabase - v2.9.0supabase_flutter - v2.10.0FIX(realtime): preserve nested empty maps in Message.toJson() (#1518).
REFACTOR (supabase_common): share the local stack test configuration ( #1640 ).
Published to pub.dev: https://pub.dev/packages/postgrest/versions/2.9.1
auth.mfa.enroll() method return value now has a nullable totp property to support phone MFA enrollment.REFACTOR: modernize dart syntax across client packages (#1574).
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 - v2.6.2supabase_flutter - v2.8.3FIX: Add error_code from url to AuthException (#968).
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 - v2.2.2supabase_flutter - v2.5.6Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
functions_client - v2.4.0gotrue - v2.10.0postgrest - v2.3.0realtime_client - v2.4.0storage_client - v2.2.0supabase - v2.5.0supabase_flutter - v2.8.0REFACTOR (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).
FEAT(storage): add download option to signed and public URLs (#1514).
Update a dependency to the latest release.
Update a dependency to the latest release.
FIX(storage): percent-encode object paths in request URLs (#1479).
REFACTOR(storage_client): dedupe retry assertion and fetch options (#1462).
FIX: raise min Dart SDK to 3.4.0 across all packages (#1409).
FIX(storage): handle null signedURL in createSignedUrls response (#1385).
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
FIX: mark lastAccessedAt field as deprecated (#1279).
FIX(storage): avoid duplicate Content-Type headers and header mutation (#1359).
FIX(types): improve JSON decoding resilience (#1301).
One column per quarter.