A few months ago, we announced a developer preview version of supabase-flutter SDK. Since then, we have heard a lot of amazing feedback from the community, and have been improving it. Today, we are happy to announce the stable v1 of supabase-flutter. You can also find the updated quick start guide, documentation and a migration guide from v0.
What is new in v1?
supabase-flutter v1 focuses on improved developer experience. The new version requires far less boiler plate code as well as it provides more intuitive APIs. Here are some highlights of the update.
No more .execute()
Previously, for .select(), .insert(), .update(), .delete() and .stream() required execute() to be called at the end. On top of that, errors are thrown, not returned, so you can be sure that you have the query results in the returned value.
_10// Before_10final response = await supabase.from('messages').select().execute();_10final data = response.data;_10_10// After_10final data = await supabase.from('messages').select();
More predictable auth methods
Names of the auth methods are more descriptive about what they do. Here are some examples of the new methods:
_10await supabase.auth.signInWithPassword(email: email, password: password);_10_10await supabase.auth.signInWithOAuth(Provider.github)
Also, onAuthStateChange returns stream, which feels more natural for anyone coding in Dart.
_10supabase.auth.onAuthStateChange.listen((data) {_10 final AuthChangeEvent event = data.event;_10 final Session? session = data.session;_10});
Realtime Multiplayer edition support
During the last launch week, we announced the general availability of Realtime Multiplayer. supabase-flutter now has first class support for the two newly introduced realtime methods, broadcast and presence. Broadcast can be used to share realtime data to all connected clients with low latency. Presence is a way to let other connected clients know the status of the client. You can visit multiplayer.dev to see a quick demo of the feature.
_31final channel = Supabase.instance.client.channel('my_channel');_31_31// listen to `location` broadcast events_31channel.on(_31 RealtimeListenTypes.broadcast,_31 ChannelFilter(_31 event: 'location',_31 ), (payload, [ref]) {_31 // Do something exciting with the broadcast event_31});_31_31// send `location` broadcast events_31channel.send(_31 type: RealtimeListenTypes.broadcast,_31 event: 'location',_31 payload: {'lat': 1.3521, 'lng': 103.8198},_31);_31_31// listen to presence states_31channel.on(RealtimeListenTypes.presence, ChannelFilter(event: 'sync'),_31 (payload, [ref]) {_31 // Do something exciting with the presence state_31});_31_31// subscribe to the above changes_31channel.subscribe((status) async {_31 if (status == 'SUBSCRIBED') {_31 // if subscribed successfully, send presence event_31 final status = await channel.track({'user_id': myUserId});_31 }_31});
These are just tip of the iceberg of all the updates that we shipped in v1. Check out the documentation to see the full list.
Acknowledgements
It required massive support from the community to bring the supabase-flutter to where it is today. I would like to thank everyone who has contributed to the library, and a special thanks to Bruno and Vinzent, who have been key for this release. We really could not have done it without you!
Resources
- Install supabase-flutter v1.0
- supabase-flutter documentation
- v0 to v1 migration guide
- Flutter Tutorial: building a Flutter chat app
- Flutter Tutorial - Part 2: Authentication and Authorization with RLS
- How to build a real-time multiplayer game with Flutter Flame
- Build a Flutter app with Very Good CLI and Supabase