NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #383 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 today
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.
FEAT: add logLevel parameter to RealtimeClientOptions (#592).
// The following will initialize Supabase that will retry failed uploads up to 25 times,
// which is about 10 minutes of retrying.
await Supabase.initialize(
supabaseUrl,
supabaseAnonKey,
storageRetryAttempts: 25,
);
FIX: Format the files to adjust to Flutter 3.10.1 (#475).
Your coding agent can read these notes before it upgrades. Set up the MCP server →
onAuthStateChangesupabase.onAuthStateChange.listen((data) {
// handle auth state change here
}, onError: (error) {
// handle error here
});
.select()// data is `List<Map<String, dynamic>>`
final data = await supabase.from('users').select<List<Map<String, dynamic>>>();
// data is `Map<String, dynamic>`
final data = await supabase.from('users').select<Map<String, dynamic>>().eq('id', myId).single();
fix: update sample code on readme.md
BREAKING: update supabase to v1.0.0
.stream() now takes a named parameter primaryKey instead of a positional argument.supabase.from('my_table').stream(primaryKey: ['id']);
.stream() has 5 additional filters: neq, gt, gte, lt, lte (148auth.signUp() now uses named parameters // Before
final res = await supabase.auth.signUp('example@email.com', 'password');
// After
final res = await supabase.auth.signUp(email: 'example@email.com', password: 'password');
auth.signIn() is split into different methods // Magic link sign-in
// Before
final res = await supabase.auth.signIn(email: 'example@email.com');
// After
final res = await supabase.auth.signInWithOtp(email: 'example@email.com');
// Email and password sign-in
// Before
final res = await supabase.auth.signIn(email: 'example@email.com', password: 'password');
// After
final res = await supabase.auth.signInWithPassword(email: 'example@email.com', password: 'password');
auth.onAuthStateChange is now a stream // Before
supabase.auth.onAuthStateChange((event, session) {
// ...
});
// After
final subscription = supabase.auth.onAuthStateChange.listen((data) {
final AuthChangeEvent event = data.event;
final Session? session = data.session;
});
// Don't forget to cancel the subscription when you're done
subscription.cancel();
auth.update() is renamed to auth.updateUser() // Before
final res = await supabase.auth.update(
UserAttributes(
email: 'new@email.com',
data: {
'username': 'new_username',
},
),
);
// After
final res = await supabase.auth.updateUser(
UserAttributes(
email: 'new@email.com',
data: {
'username': 'new_username',
},
),
);
SupabaseAuth.instance.onAuthChange() is now removed and supabase.auth.onAuthStateChange() should be used insteadfix: update supabase to v1.0.0-dev.9
PostgrestClient with proper auth headers when calling .rpc() (#143)SupabaseClient (#144)BREAKING: update supabase to v1.0.0-dev.7
returning behavior in postgrest v1.0.0-dev.4chore: update supabase to v1.0.0-dev.6
.stream() typing issue #138deprecated: .stream() no longer needs .execute()
.stream() no longer needs .execute()eq filter on .stream() is a separate method now// before
Supabase.instance.client.from('my_table:title=eq.Supabase')
.stream(['id'])
.order('created_at')
.limit(10)
.execute()
.listen((payload) {
// do something with payload here
});
// now
Supabase.instance.client.from('my_table')
.stream(['id'])
.eq('title', 'Supabase')
.order('created_at')
.limit(10)
.listen((payload) {
// do something with payload here
});
final channel = Supabase.instance.client.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});
}
});
chore: add example app in example directory
WidgetsBinding warningBREAKING: update supabase package v1.0.0-dev.4
BREAKING: update supabase package v1.0.0-dev.3
- feat: custom http client
feat: add Mac OS and Windows support for deep links
// Before
await Supabase.initialize(
url: 'SUPABASE_URL',
anonKey: 'SUPABASE_ANON_KEY',
);
...
// Class extending `SupabaseAuthState` or `AuthRequiredState` was necessary
// to persist auth state
class AuthState<T extends StatefulWidget> extends SupabaseAuthState<T> {
...
}
// After
// Initializing Supabase is all you need to do to persist auth state
// Deep links will also be automatically handled when you initialize Supabase.
await Supabase.initialize(
url: 'SUPABASE_URL',
anonKey: 'SUPABASE_ANON_KEY',
);
...
// You can get the initial session of the user with `SupabaseAuth.instance.initialSession`
try {
final initialSession = await SupabaseAuth.instance.initialSession;
} catch(error) {
// Handle errors in session initial recovery here
}
// You should now use `onAuthStateChanged` as the
Supabase.instance.client.auth.onAuthStateChange((event, session) {
// handle sign-in/signups here
});
feat: update supabase package v0.3.6
Update a dependency to the latest release.
Published to pub.dev: https://pub.dev/packages/supabase_flutter_web_auth/versions/0.3.2
Update a dependency to the latest release.
Published to pub.dev: https://pub.dev/packages/supabase_flutter_web_auth/versions/0.3.1
chore: add multiple Flutter version to the CI pipeline
chore: update supabase package v0.3.4+1
fix: OAuth authentication page should open in an external browser
Note: This release has breaking changes.
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_test/versions/0.3.0
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_typegen/versions/0.3.0
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_flutter_web_auth/versions/0.3.0
chore: update supabase-dart package v0.2.14
chore: update supabase-dart package v0.2.13
chore: update supabase-dart package v0.2.12
fix: update code samples to reflect breaking change from v0.0.3
onUnauthenticated()chore: update supabase to v0.2.7
chore: update supabase to v0.2.6
- fix: export local_storage
chore: update supabase to v0.2.5
chore: update supabase to v0.2.4
chore: update supabase to v0.2.3
Update a dependency to the latest release.
Published to pub.dev: https://pub.dev/packages/supabase_flutter_web_auth/versions/0.2.2
FEAT (storage): add file versioning and bucket lifecycle policies ( #1834 ).
Published to pub.dev: https://pub.dev/packages/supabase_test/versions/0.2.1
Published to pub.dev: https://pub.dev/packages/supabase_flutter_web_auth/versions/0.2.1
Note: This release has breaking changes.
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_typegen/versions/0.2.0
Note: This release has breaking changes.
Published to pub.dev: https://pub.dev/packages/supabase_flutter_web_auth/versions/0.2.0
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
gotrue - v2.27.1postgrest - v2.9.1realtime_client - v2.13.0storage_client - v2.8.0supabase - v2.16.0supabase_common - v0.1.2supabase_typegen - v0.1.1supabase_flutter - v2.17.1functions_client - v2.7.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_flutter - v2.17.1functions_client - v2.7.1Supabase.initialize is now Future<void>chore: update supabase to v0.0.8
chore: update supabase to v0.0.7
chore: update supabase to v0.0.5
chore: update supabase to v0.0.4
chore: update supabase to v0.0.3
BREAKING CHANGE: rework Supabase singleton with Supabase.initialize and Supabase.instance
Supabase.initialize and Supabase.instancefeat: support custom localStorage with fallback to SharedPreferences as default
chore: update supabase, url_launcher packages
fix: launch url in the current tab for flutter web
- feat: support flutter web
chore: update supabase to v0.0.1
feat: support nested authentication flow with startAuthObserver() and stopAuthObserver()
- Initial pre-release.
One column per quarter.