NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #367 most downloaded on pub.dev
PostgREST client for Dart. This library provides an ORM interface to PostgREST.
Last release 3 days ago
06 Oct 2026
Release timing varies
gaps range from 8 days to 5 months
Nearly every release is documented
notes for 59 of 59 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
83 releases · first in 2020
One column per quarter.
REFACTOR : define shared HTTP header names in supabase_common ( #1917 ).
Published to pub.dev: https://pub.dev/packages/supabase_flutter/versions/3.0.0-dev.9
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.
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_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.
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
REFACTOR : define shared HTTP header names in supabase_common ( #1917 ).
Published to pub.dev: https://pub.dev/packages/supabase_common/versions/3.0.0-dev.6
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
Note: This release has breaking changes.
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.5
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_flutter/versions/3.0.0-dev.5
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_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.
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_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
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.
REFACTOR(supabase_common): share the local stack test configuration (#1640).
REFACTOR(supabase_common): share the local stack test configuration (#1640).
FIX(postgrest): stop seeding Prefer header with an empty string (#1505).
FIX(postgrest): escape quotes and backslashes in list filter values (#1481).
FIX: raise min Dart SDK to 3.4.0 across all packages (#1409).
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).
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).
- FEAT: Add logging (#1042).
FIX: Upgrade web_socket_channel for supporting web: ^1.0.0 and therefore WASM compilation on web (#992).
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.4Packages 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:
FIX: PKCE flow not emitting password recovery event (#744).
schema variable private and rename useSchema() to schema() (#737).FIX: issue where .range() not respecting the offset given. (#722).
FIX(functions_client): use header for response parsing (#616).
Note: This release has breaking changes.
FIX: don't try to decode an empty body (#631).
FIX: don't try to decode an empty body (#631).
FEAT(postgrest,supabase): add useSchema() method for making rest API calls on custom schema. (#525).
FIX: make Supabase client work in Dart Edge again (#675).
FIX(postgrest): update docs to mention views (#543).
REFACTOR: bump minimum Dart SDK version to 2.17.0 (#510).
FIX: Update http dependency constraints (#491).
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.19chore: move the repo into supabase-flutter monorepo
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_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).
REFACTOR: bump minimum Dart SDK version to 2.17.0 (#510).
FIX: Format the files to adjust to Flutter 3.10.1 (#475).
.select() #94// data is `List<Map<String, dynamic>>`
final data = await supabase.from<List<Map<String, dynamic>>>('users').select();
// data is `Map<String, dynamic>`
final data = await supabase.from<Map<String, dynamic>>('users').select().eq('id', myId).single();
fix: calling .select() multiple times will override the previous .select() #95
.select() multiple times will override the previous .select() #95BREAKING: set minimum Dart SDK version to 2.15.0 #92
fix: update insert documentation to reflect new returning behavior #88
returning behavior #88fix: List as value in any filter #85
BREAKING: rename PostgrestError to PostgrestException
PostgrestError to PostgrestExceptionDEPRECATED: .execute() is now deprecated
data is returned directly and error is thrown instead of being returned within a responsetry {
final data = await client.from('countries').select();
print(data);
} on PostgrestError catch (error, stacktrace) {
// handle a PostgrestError
print('$error \n $stacktrace');
} catch (error, stacktrace) {
// handle other errors
print('$error \n $stracktrace');
}
count and head can be specified within FetchOptions() in .select()final response = await client.from('countries').select('*', FetchOptions(count: CountOption.exact));
print(response.data);
print(response.count);
returning option in .insert(), .upsert(), .update() and .delete() have been removed. .select() should be appended on the query to return the result of those operations.final data = await client.from('countries').insert({'name': 'France'}).select();
.execute() is now deprecatedlints package for lintingfix: order() and limit() not working as expected with foreign table bug
order() and limit() not working as expected with foreign table bugor filterfix: bug where using multiple filters on the same field with order will wipe out the filters except the last one.
fix: bug where multiple order does not reorder the result
order does not reorder the resultfeat: added withConverter to PostgrestBuilder `dart final res = await postgrest .from('users') .select() .withConverter ((data) => [data]) .execute();
withConverter to PostgrestBuilderfinal res = await postgrest
.from('users')
.select()
.withConverter<List>((data) => [data])
.execute();
List passed to filter, eq or neq will correctly be formattedfix: bug where filter is not available on rpc()
filter is not available on rpc()Update a dependency to the latest release.
Published to pub.dev: https://pub.dev/packages/supabase_flutter_web_auth/versions/0.1.7
Your coding agent can read these notes before it upgrades. Set up the MCP server →