Breaking Change: supabase-flutter v3 brings type safety to the whole API surface
Component: supabase · Channel: stable. Automated analysis, not a compatibility certification. How this works.
Analysis updated: 2026-11-06.
Supabase has announced supabase-flutter v3, introducing end-to-end type safety, native Dart idioms, and major breaking architectural changes across the entire client library surface. The stable release is scheduled for November 11, 2026, with current prereleases available on pub.dev.
💻 Software Engineers & Devs
Migrate your codebase to v3 to leverage end-to-end type safety, update renamed core packages, and adapt to breaking changes like default sort directions and native Dart types.
📊 Product & Engineering Leads
Plan engineering capacity for the v3 migration to ensure smooth upgrades before v2 support ends 6 months post stable release.
⚙️ DevOps & Security
Ensure self-hosted GoTrue instances are updated to API version 2024-01-01 or newer, and coordinate simultaneous deployments for apps sharing realtime broadcast channels.
✨ New Features & Capabilities (3)
- End-to-end type safety via supabase gen types and the new supabase.table() API
- Native Dart types such as DateTime, Uri, Duration, Stream, and sealed AuthState
- Package skills for AI coding agents including Claude Code, Cursor, Gemini, and Copilot
⚡ Performance & Enhancements (2)
- Additive typed API via table() allowing gradual migration alongside from()
- Unified SupabaseException base class for all service exceptions