supabase_flutter
2.18.3, released 6 weeks ago by supabase.io
Flutter client for Supabase providing auth, database, realtime, storage and edge functions.
What it does
It wraps Supabase's Dart SDK for Flutter, handling initialization, authentication flows, realtime subscriptions, storage access and edge function calls. It also offers utilities like deep linking and custom local storage.
AI-written summary of version 2.18.3, based on the package's README and metadata. Report an inaccuracy
Use it when
- You need a full‑stack backend with auth, database and realtime features in a Flutter app
- You prefer Supabase over Firebase or other BaaS solutions
- You want a single package to manage Supabase services across mobile, web and desktop
Skip it when
- You only need a lightweight HTTP client without backend integration
- You are using a different backend provider such as Firebase or a custom GraphQL server
Strengths
- Comprehensive Supabase integration (auth, db, realtime, storage)
- Cross‑platform support (mobile, web, desktop)
- Stream‑based auth state changes for reactive UI
Weaknesses
- Relies on Supabase ecosystem; not useful for other backends
- Adds a layer of abstraction that may hide low‑level Supabase client details
- Native sign‑in (Apple/Google) requires additional packages and platform setup
Setup
- Kind
- Flutter widgets
- Effort
- Medium
- Code generation
- No
- Direct dependencies
- 11
Add supabase_flutter to pubspec, call Supabase.initialize in main before runApp, configure platform-specific settings for native Apple/Google sign‑in, and optionally set up deep links and custom local storage.
import 'package:supabase_flutter/supabase_flutter.dart';
void main() async {
WidgetsFlutterBinding.ensureInitialized();
await Supabase.initialize(url: 'YOUR_URL', publishableKey: 'YOUR_KEY');
runApp(MyApp());
}
final supabase = Supabase.instance.client;
// Sign up example
await supabase.auth.signUp(email: 'test@example.com', password: 'password');Alternatives
Packages that do the same job and could replace supabase_flutter.
- gotrue
Dart client for Supabase Auth API
85Compare - postgrest
Dart client library offering an ORM‑like interface to PostgREST/Supabase databases.
88Compare - realtime_client
Dart client for Supabase Realtime, listening to PostgreSQL changes via WebSocket
89Compare - functions_client
Dart client for invoking Supabase Edge Functions.
79Compare
Works with
Packages commonly used together with supabase_flutter: ones it builds on, ones built on it, and its own family.
- websupabase_flutter depends on itLightweight bindings for browser APIs via JS interop
- asyncsupabase_flutter depends on itUtility classes and helpers that extend Dart's async library.
- loggingsupabase_flutter depends on itProvides configurable logging with levels and stream listeners for Dart apps.
- url_launchersupabase_flutter depends on itFlutter plugin for launching URLs across mobile, desktop, and web platforms.
- shared_preferencessupabase_flutter depends on itFlutter plugin for reading and writing simple key-value pairs. Wraps NSUserDefaults on iOS and SharedPreferences on Android.
- app_linkssupabase_flutter depends on itHandler for Android App Links, iOS Universal Links, and custom URL schemes across mobile and desktop.
- supabasesupabase_flutter depends on itDart client for Supabase, usable in non-Flutter Dart environments.
- mock_supabase_http_clientSame familyA mock Supabase client for unit testing API calls without network requests.