Supabase Flutter v3 brings full type safety, breaks four packages
supabase-flutter 3.0.0 generates Dart types from your schema and swaps callbacks for streams. Four underlying packages are renamed and marked discontinued.
Supabase shipped the stable 3.0.0 release of supabase-flutter on 11 November. Queries now return generated types, such as List<BooksRow>, instead of List<Map<String, dynamic>>, and timestamps, URLs and durations come back as DateTime, Uri and Duration rather than strings.
The release renames the underlying packages: gotrue, realtime_client, storage_client and functions_client become supabase_auth, supabase_realtime, supabase_storage and supabase_functions, and the old names are now marked discontinued on pub.dev. Realtime listeners move from callbacks to Streams, AuthState becomes a sealed class for exhaustive switch statements, and from() is replaced by a typed table() call. The anonKey parameter on Supabase.initialize is renamed to publishableKey.
// v2: descending by default, the opposite of SQL
.order('created_at') // add ascending: false to keep old behaviour
// v3: table() replaces from() for typed queries
supabase.table(Books.table)
Why it matters: if you depend directly on any of the four renamed packages, your imports break on upgrade, and order()’s default sort direction flips to match SQL. Supabase is keeping v2 on security and critical fixes for six months, so there is a window to migrate rather than freeze your dependency.