Prepare for the PgBouncer and IPv4 deprecations on 26th January 2024

Learn more

Supabase Flutter SDK 1.0 Developer Preview

2022-08-02

6 minute read

Today, we are releasing of Developer Preview version of v1.0 of Supabase Flutter SDK. Flutter has quickly become one of the most popular frameworks for developers to build cross-platform mobile apps. We can attest to that growth, our Flutter SDK is one of the most popular libraries and each day we see more Flutter devs choosing Supabase.

For this release, our main focus is developer experiences. We would love for you to try the SDK and provide your feedback so that we can continue to improve!

Before we dive into the actual updates, I would like to thank all the community contributors who have helped the library to be where it is today.

Better developer experience

Until now, there were some disputable implementations in the Flutter SDK. We've made several improvements:

Automatically handling auth state persistence

Previously, supabase-flutter required a class that extends SupabaseAuthState or SupabaseAuthRequiredState to persist auth state. With supabase-flutter 1.0, you no longer need to include these classes.

All you need to persist the auth state is initialize Supabase and everything else will be automatically taken care of. SupabaseAuthState and SupabaseAuthRequiredState have been removed from the code base.


_16
// Before
_16
await Supabase.initialize(
_16
url: 'SUPABASE_URL',
_16
anonKey: 'SUPABASE_ANON_KEY',
_16
);
_16
...
_16
_16
class AuthState<T extends StatefulWidget> extends SupabaseAuthState<T> {
_16
...
_16
}
_16
_16
// After
_16
await Supabase.initialize(
_16
url: 'SUPABASE_URL',
_16
anonKey: 'SUPABASE_ANON_KEY',
_16
);

Deep link handling had similar issues previously, requiring you to implement SupabaseAuthState or SupabaseAuthRequiredState classes.

With the 1.0 update, you no longer need to use these classes, and deep links will be automatically handled. You can listen to onAuthStateChange to handle when a deep link is received to redirect users to a new screen.


_10
// Before
_10
void onReceivedAuthDeeplink(Uri uri) {
_10
Supabase.instance.log('onReceivedAuthDeeplink uri: $uri');
_10
}
_10
_10
// After
_10
await Supabase.instance.initialize(
_10
url: 'SUPABASE_URL',
_10
anonKey: 'SUPABASE_ANON_KEY',
_10
);

Throwing errors instead of returning them

When supabase-dart and supabase-flutter were created, we wanted to mirror the JavaScript library as much as possible. We soon realized that some syntax does not fit well when written in Dart. Throwing vs returning error is a good example of that. Since Dart does not have object destruction, the code becomes a bit tedious when errors are returned.

With supabase-flutter 1.0, we are throwing errors instead of returning them. This is consistent across all features from auth, postgrest, and storage.


_11
// Before
_11
final response = await Supabase.instance.from('messages').select().execute();
_11
final data = response.data;
_11
final error = response.error;
_11
_11
// After
_11
try {
_11
final data = await Supabase.instance.from('messages').select();
_11
} catch(error) {
_11
// Handle error here
_11
}

No more .execute() to get the data

We want this SDK to be as close as possible to the JavaScript SDK to provide consistent developer experience no matter what programming language you are using. Prior to the 1.0 update, whenever you called the postgrest endpoints, you had to call .execute() at the end of each query.

.execute() is now deprecated. You no longer needed it to query data from your Supabase database. This update, along with many many other improvements across the whole library, has been done by Bruno D'Luka, and I would love to give him a special shout out here!


_10
// Before
_10
final response = await Supabase.instance.from('messages').select().execute();
_10
final data = response.data;
_10
_10
// After
_10
final data = await Supabase.instance.from('messages').select();

Ever since supabase-flutter was born, it supported only iOS, Android and Web for deep linking. This was a limitation of the deep link library that we were using.

With the 1.0 launch, we are moving to use app_links, which will enable us to support MacOS and Windows applications as well! Linux support is being worked on - follow the repo to keep updated.

Supabase Flutter desktop support

Multiplayer support

Multiplayer is the next generation Supabase Realtime engine that was announced at the previous launch week.

We want our Flutter developers to experience this new multiplayer feature as well, so are working hard at bringing it to our Flutter SDK. It is not yet included in the developer preview of Supabase Flutter 1.0, but will be part of it when stable launch has been released.

Supabase Auth UI for Flutter

Supabase Auth UI for Flutter

Last but not least, we are bringing you another library, the Supabase Auth UI for Supabase! When released, this library will enable you to implement a basic authentication screen without building it yourself. You can just load the library and display a nice looking Auth UI. The library takes your theme settings automatically to match the look and feel of your application.

You can get started with it on pub.dev.

I would like to thank Fatuma for single-handedly working on bringing us an easier authentication experience.


_17
// Email and password signin form
_17
SupaEmailAuth(
_17
authAction: AuthAction.signIn,
_17
redirectUrl: '/home',
_17
),
_17
_17
// Magic Link signin form
_17
SupaMagicAuth(),
_17
_17
// Social Login Buttons
_17
SupaSocialsAuth(
_17
socialProviders: [
_17
SocialProviders.apple,
_17
SocialProviders.google,
_17
],
_17
colored: true,
_17
),

Final thoughts

These updates are just the tip of the iceberg for 1.0. There are been many bug fixes and features constantly being added to the Supabase Flutter SDK. This could not have been possible without the help from the open source community. Here, I would also like to give a shout out to two other developers who have been a major part of the journey of this SDK: Vinzent and Daniel Mossaband. They have been a huge part of the Supabase Flutter SDK - not just for the 1.0 release, but throughout the lifetime of the library. For those of you who want to try out the new SDK, you can get the developer preview version from supabase-flutter pub.dev page or can simply copy and paste the following into your pubspec.yaml file.


_10
supabase_flutter: ^1.0.0-dev.1

If you have any feedbacks, please let us know in the issues of the supabase-flutter repository.

Flutter Resources

Share this article

Build in a weekend, scale to millions