supabase/supabase-flutter
58.8
Adequate · 5 November 2026
48.8k
lines of production code
Dart
primary language
4
measurements over time
What this system is
Features
Add Linux build support to the Supabase Flutter example app
The example application now includes the necessary Linux platform files (CMakeLists.txt, main.cc, my\_application.cc, and generated plugin registrants) to build and run on Linux. This enables users to develop and test Supabase Flutter integrations on the Linux desktop environment using GTK.
_packages/supabase\flutter/example/linux · high confidence
Add Postgrest client usage example
A new example file demonstrates how to initialize the PostgrestClient with a URL and API key, query a table, and handle PostgrestApiException errors.
packages/postgrest/example · high confidence
Add Windows platform support to the example app
The example application now includes the necessary Windows runner files, CMake build configuration, and plugin registration to build and run on Windows. This enables users to test the Supabase Flutter integration on the Windows desktop platform using the standard Flutter tooling.
_packages/supabase\flutter/example/windows · high confidence
Add example demonstrating YAJsonIsolate usage
An example file has been added to the yet\_another\_json\_isolate package that shows how to initialize the isolate, decode a JSON string, encode a JSON object, and properly dispose of the isolate.
_packages/yet\_another\_json\isolate/example · high confidence
Add macOS native runner to the Supabase Flutter example app
The macOS example application is now fully scaffolded, providing a complete native Xcode project structure (including the Runner target, build configurations, and entitlements) so users can build and run the Supabase Flutter example on macOS. The native side registers essential plugins—app\_links, shared\_preferences\_foundation, and url\_launcher\_macos—ensuring these platform features work correctly in the example.
_packages/supabase\flutter/example/macos · high confidence
Add passkey options mapper for WebAuthn compatibility
A new internal mapper converts WebAuthn registration and authentication options from the Supabase API into formats compatible with the \passkeys\ plugin. This ensures that challenges and credential IDs have base64url padding stripped and that excluded or allowed credentials include a \transports\ list, resolving issues where the plugin rejected padded values or missing transport data.
_packages/supabase\flutter/lib/src/passkey · high confidence
Add web-based Supabase Dart example application
A new web example has been added to the Supabase Dart package, providing a complete, runnable demonstration of client-side usage. The example includes an HTML entry point and a Dart main file that showcases core Supabase capabilities, including database queries (select, insert, update, delete), real-time PostgreSQL change subscriptions, data streaming, and storage operations (upload, download, signed URL generation, and deletion).
packages/supabase/example/web · high confidence
Added example project scaffolding and configuration
The example application now includes essential configuration files to support development and analysis. A .gitignore file excludes standard build artifacts and IDE-specific files, while a .metadata file tracks the Flutter project's stable channel and migration state. The analysis\_options.yaml file is configured to use supabase\_lints and explicitly disables the single-widget-per-file rule to accommodate the demo app's structure. Additionally, a README.md provides SQL setup instructions for Supabase tables, policies, and storage buckets required for the profile example.
_packages/supabase\flutter/example · high confidence
Introduce Supabase Functions client library with structured error handling
The new supabase\_functions package provides a Dart client for invoking Supabase Edge Functions, featuring a structured exception hierarchy that distinguishes between API errors (FunctionsApiException) and general transport or processing failures (FunctionException). The library exports core types from supabase\_common and yet\_another\_json\_isolate, ensuring consistent error reporting and asynchronous JSON processing for users interacting with Edge Functions.
_packages/supabase\functions/lib · high confidence
Introduce resumable upload support and rename package to supabase\_storage
The storage client library has been renamed to supabase\_storage and now exposes resumable upload capabilities, allowing users to pause, resume, and cancel large file transfers via the new ResumableUpload API. The public API surface has been expanded to include resumable upload types (MemoryResumableUploadStorage, ResumableUploadOptions, etc.) alongside existing storage operations, and the library re-exports common exception and retry types from supabase\_common to provide a unified error handling experience.
_packages/supabase\storage/lib · high confidence
Introduce shared Supabase lint configuration package
A new \supabase\_lints\ package has been added to provide a centralized linting configuration for Supabase Dart and Flutter packages. It includes a shared \analysis\_options.yaml\ that extends \lints/recommended\ and the Dart Code Metrics (DCM) \recommended\ preset, enforcing rules such as \unawaited\_futures\, \lines\_longer\_than\_80\_chars\, and \sort\_constructors\_first\. It also enforces Web and WASM compatibility by banning imports of \dart:html\, \dart:js\, \dart:js\_util\, and \dart:ffi\ (except in conditional \\_io.dart\ files). A separate \analysis\_options\_flutter.yaml\ is provided for Flutter packages, which includes the Dart configuration plus \flutter\_lints/flutter.yaml\.
_packages/supabase\lints/lib · high confidence
Introduce supabase\_auth package with comprehensive admin and user-facing APIs
The library now exposes a full-featured \AuthClient\ for user authentication (including PKCE, MFA, passkeys, and OAuth) alongside a new \AuthAdminApi\ for server-side management of users, MFA factors, OAuth clients, custom OIDC/OAuth providers, passkeys, and SAML 2.0 SSO providers. This release also adds experimental MFA recovery codes support and requires \asyncStorage\ for PKCE flows and session persistence.
_packages/supabase\auth/lib · high confidence
Introduce supabase\_typegen for generating typed Dart table definitions
The new supabase\_typegen package generates Dart code that provides strongly-typed row, insert, and update types for your Supabase database tables, eliminating the need to handle raw Map data. It introspects your database schema (via the Supabase CLI or a direct connection) and emits a single Dart file containing typed table definitions, column tokens for compile-time checked queries, and support for complex types like arrays, ranges, and pgvector. This allows you to write type-safe queries and mutations with full IDE support. Also in this area: 1 commit (0 fixes) modifying packages/supabase\_typegen, skills\_src; Typegen now relies on CLI-provided metadata and marks view columns as non-required.
_packages/supabase\_typegen/bin, packages/supabase\typegen/tool · medium confidence · unverified
New Edge Functions example app and integration tests
Added a new Flutter example application in \examples/edge\_functions\ that demonstrates calling Supabase Edge Functions via \supabase.functions.invoke(...)\. The app showcases invoking functions with JSON bodies over POST, query parameters over GET, custom headers, plain text payloads, and error handling for non-2xx responses. It includes a \FunctionsRepository\ to separate API logic from the UI, along with end-to-end integration tests (\functions\_test.dart\ and \invoke\_test.dart\) that verify the full surface of the \invoke\ method, including various HTTP methods, request bodies (JSON, text, binary, multipart), response types (JSON, text, binary, SSE), and error scenarios.
_examples/edge\functions · high confidence
New Storage example demonstrating image uploads and on-the-fly transformations
A new Flutter example application has been added to showcase Supabase Storage capabilities, specifically focusing on uploading images and applying server-side transformations. The app generates sample images in memory and uploads them to a public 'images' bucket, then displays them in a gallery using resized thumbnails. Tapping an image opens a detail view that renders multiple transformation variants (such as cover, contain, and low-quality) by passing \TransformOptions\ to the public URL and download methods. The example includes a dedicated \StorageRepository\ to isolate Supabase calls and an end-to-end integration test that verifies the upload, list, transformed download, and delete workflows.
_examples/storage\transforms · high confidence
New local Supabase example launcher
A new launcher tool has been added to the examples directory, allowing users to start a local Supabase stack, select from available Flutter examples, and run them with the correct local credentials. The launcher handles environment setup, including starting and stopping the Supabase services, and forwards arguments to the Flutter runner, simplifying the process of testing examples locally.
examples/launcher · high confidence
New passkeys example app for Flutter Web
A new example application has been added to demonstrate passkey (WebAuthn) authentication using \supabase\_flutter\. The app allows users to sign in with email and password, register a new passkey, and subsequently sign in using that passkey without a password. It also includes functionality to list, rename, and delete existing passkeys. The example is configured to work with a local Supabase stack via a shared launcher and includes an end-to-end integration test to verify the sign-up and sign-in flows.
examples/passkeys · high confidence
New realtime room example demonstrating Postgres Changes, Broadcast, and Presence
Added a new Flutter example application (\examples/realtime\_room\) that showcases Supabase Realtime's three core features in a live chat interface. The app uses Postgres Changes to keep a message list in sync across clients, Broadcast for ephemeral typing indicators, and Presence to display a live roster of connected users. The example includes a complete implementation with a \RoomChannel\ for realtime subscriptions, a \RoomRepository\ for database operations, and an end-to-end integration test (\integration\_test/room\_test.dart\) that validates the full user flow. Also in this area: Added integration test for realtime room with persistent auth storage.
_examples/realtime\_room/integration\test · high confidence
New shared local Supabase setup and launcher for examples
Developers can now run the \supabase\_flutter\ examples locally using a single launcher script (\run.sh\) that boots a shared Supabase instance and automatically wires the local credentials into the selected example. This setup includes a pre-configured \config.toml\ enabling authentication (email, phone, passkeys), Edge Functions, Storage, and Realtime, along with the necessary database migrations, seed data, and Edge Function implementations to demonstrate these features out of the box.
examples/supabase · high confidence
New testing helpers and restructured public exports in supabase\_flutter
The \supabase\_flutter\ package now exposes a \testing.dart\ library that provides \initializeTestSupabase\, a helper for widget and unit tests that configures an in-memory session, disables token auto-refresh and deep-link detection, and accepts mock HTTP and realtime transports for isolated testing. The main \supabase\_flutter.dart\ entry point has been restructured to explicitly export the new \supabase\_auth\ module, \RealtimeLifecycleOptions\, \OAuthLauncher\, \SharedPreferencesAsync\ storage, and passkey/restore-credential utilities, aligning the public API with the underlying package-specific configurations.
_packages/supabase\flutter/lib · high confidence
Supabase Storage client v3.0.0 introduces resumable uploads, vector search, and bucket versioning
The \supabase\_storage\ package has been rewritten for v3.0.0, introducing support for resumable file uploads with pause, resume, and cancel capabilities, as well as the ability to report upload progress and download byte ranges. The client now supports bucket-level object versioning and lifecycle policies, allowing users to manage previous versions of files. Additionally, a new experimental Vector API is available for managing vector buckets and indexes, enabling similarity searches. The storage client also features an idle timeout for requests, improved error handling with transport exceptions, and a new hostname rewriting mechanism for legacy storage URLs.
_packages/supabase\storage/lib/src · high confidence
Removals
Removal of legacy Flutter auth state management and singleton classes
The \lib/src\ directory has removed the legacy \Supabase\ singleton class, \SupabaseAuthState\, \SupabaseDeepLinkingMixin\, \SupabaseLifecycleState\, and the \constants.dart\ file. This cleanup eliminates the previous implementation of session persistence via \SharedPreferences\, deep-link handling mixins, and lifecycle-aware auth state widgets, indicating a shift away from these specific internal abstractions in favor of a newer architecture.
lib/src · high confidence
Architecture
Introduction of supabase\_common package for shared utilities
A new supabase\_common package has been introduced to centralize shared internal utilities across the Supabase client ecosystem. This change extracts common code such as HTTP handling, authentication callbacks, retry logic, and platform info into a single location, reducing duplication between client packages. It also includes a testing library for local stack configuration to ensure integration tests remain consistent across packages.
_packages/supabase\common/lib · high confidence
Behavioural changes
10 commits (3 fixes) modifying skills\_src/migrate-v3
A change to existing behaviour in skills\_src/migrate-v3 — 10 commits (3 fixs), 1 file: “refactor(supabase)!: client setup and options consistency before 3.0.0 (\#2021)”; “docs: fix README, MIGRATION.md and skill content that disagrees with the v3 code (\#2039)”; “feat: ship agent skills with supabase\_flutter, supabase, supabase\_typegen and supabase\_test (\#2011)”; and 7 more (refs \#2021, \#2039, \#2011, \#2031, \#2032, …).
_skills\src/migrate-v3 · medium confidence · unverified
10 commits (5 fixes) modifying examples/database\_crud
A change to existing behaviour in examples/database\_crud — 10 commits (5 fixs), 7 files: “refactor!: split every service exception into a client and an api base (\#1644)”; “test(examples): add end-to-end test for the database CRUD example (\#1622)”; “ci(examples): fix the example integration test jobs (\#1643)”; and 7 more (refs \#1644, \#1622, \#1643, \#2009, \#1616, …).
_examples/database\crud · medium confidence · unverified
13 commits (3 fixes) modifying supabase/migrations
A change to existing behaviour in supabase/migrations — 13 commits (3 fixs), 7 files: “feat(typegen)!: read pg\_lsn and macaddr columns into value types (\#1994)”; “feat: support more realtime filters and multiple filters for stream (\#1610)”; “fix(typegen): disambiguate embeds of opposite-direction keys and junction tables, alias embeds named like columns (\#2020)”; and 10 more (refs \#1994, \#1610, \#2020, \#1905, \#1411, …).
supabase/migrations · medium confidence · unverified
13 commits (6 fixes) modifying examples/realtime\_room
A change to existing behaviour in examples/realtime\_room — 13 commits (6 fixs), 8 files: “refactor!: split every service exception into a client and an api base (\#1644)”; “refactor(realtime)!: replace listener callbacks with streams (\#1706)”; “fix(examples): correct the realtime room delete payload comments (\#2013)”; and 10 more (refs \#1644, \#1706, \#2013, \#1712, \#2036, …).
_examples/realtime\room · medium confidence · unverified
14 commits (7 fixes) modifying packages/iceberg/lib
A change to existing behaviour in packages/iceberg/lib — 14 commits (7 fixs), 9 files: “refactor(storage)!: move the Iceberg catalog into its own package (\#1711)”; “refactor(storage)!: share one SortDirection enum across the packages (\#1752)”; “fix(iceberg): read decoded JSON through JsonFields (\#2084)”; and 11 more (refs \#1711, \#1752, \#2084, \#1917, \#2043, …).
packages/iceberg/lib · medium confidence · unverified
2 commits (1 fix) modifying packages/supabase\_flutter\_web\_auth/lib
A change to existing behaviour in packages/supabase\_flutter\_web\_auth/lib — 2 commits (1 fix), 4 files: “fix(supabase\_flutter\_web\_auth)!: report a cancelled sign-in without throwing (\#2018)”; “feat(supabase\_flutter): pluggable OAuth launcher + opt-in supabase\_flutter\_web\_auth (\#1807)” (refs \#2018, \#1807).
_packages/supabase\_flutter\_web\auth/lib · medium confidence · unverified
23 commits (5 fixes) modifying packages/postgrest/lib
A change to existing behaviour in packages/postgrest/lib — 23 commits (5 fixs), 1 file: “refactor!: split every service exception into a client and an api base (\#1644)”; “fix!: throw AccessTokenException when the accessToken callback fails (\#1989)”; “refactor!: share a single HttpMethod enum across the packages (\#1678)”; and 20 more (refs \#1644, \#1989, \#1678, \#1994, \#1738, …).
packages/postgrest/lib · medium confidence · unverified
23 commits (6 fixes) modifying packages/supabase\_test/lib
A change to existing behaviour in packages/supabase\_test/lib — 23 commits (6 fixs), 13 files: “feat(supabase\_test): match table and rpc stubs on the schema (\#1820)”; “refactor: rename supabase\_testing to supabase\_test (\#1812)”; “refactor(supabase)!: client setup and options consistency before 3.0.0 (\#2021)”; and 20 more (refs \#1820, \#1812, \#2021, \#1857, \#2037, …).
_packages/supabase\test/lib · medium confidence · unverified
3 commits (0 fixes) modifying examples/supabase/functions
A change to existing behaviour in examples/supabase/functions — 3 commits, 4 files: “docs(examples): add Edge Functions example (\#1632)”; “feat(functions)!: response headers, a region type, consistent naming and errors that stay in FunctionsException (\#2031)”; “test(examples): add full e2e suite for Edge Functions (\#1633)” (refs \#1632, \#2031, \#1633).
examples/supabase/functions · medium confidence · unverified
3 commits (0 fixes) modifying packages/supabase\_functions/example
A change to existing behaviour in packages/supabase\_functions/example — 3 commits, 1 file: “docs: fix README, MIGRATION.md and skill content that disagrees with the v3 code (\#2039)”; “feat(functions)!: response headers, a region type, consistent naming and errors that stay in FunctionsException (\#2031)”; “feat!: rename the functions\_client package to supabase\_functions (\#1713)” (refs \#2039, \#2031, \#1713).
_packages/supabase\functions/example · medium confidence · unverified
3 commits (1 fix) modifying packages/supabase\_typegen/lib
A change to existing behaviour in packages/supabase\_typegen/lib — 3 commits (1 fix), 1 file: “feat: add supabase\_typegen package generating typed table definitions (\#1635)”; “fix(supabase\_typegen): format generated code for language version 3.8 (\#1874)”; “feat(typegen): add supabase\_typegen skeleton package (\#1636)” (refs \#1635, \#1874, \#1636).
_packages/supabase\typegen/lib · medium confidence · unverified
43 commits (14 fixes) modifying packages/supabase\_common/lib/src
A change to existing behaviour in packages/supabase\_common/lib/src — 43 commits (14 fixs), 25 files: “refactor!: split every service exception into a client and an api base (\#1644)”; “fix!: throw AccessTokenException when the accessToken callback fails (\#1989)”; “docs: fix inaccurate dartdoc comments across all packages (\#1659)”; and 40 more (refs \#1644, \#1989, \#1659, \#1678, \#1712, …).
_packages/supabase\common/lib/src · medium confidence · unverified
5 commits (0 fixes) modifying scripts
A change to existing behaviour in scripts — 5 commits, 5 files: “docs: fix README, MIGRATION.md and skill content that disagrees with the v3 code (\#2039)”; “feat: ship agent skills with supabase\_flutter, supabase, supabase\_typegen and supabase\_test (\#2011)”; “docs: fix stale v3 docs and compile-check the root README, MIGRATION.md and example READMEs (\#2052)”; and 2 more (refs \#2039, \#2011, \#2052, \#1528, \#2048).
scripts · medium confidence · unverified
5 commits (1 fix) modifying examples/supabase/migrations
A change to existing behaviour in examples/supabase/migrations — 5 commits (1 fix), 4 files: “fix(examples): correct the realtime room delete payload comments (\#2013)”; “docs(examples): add Storage uploads and image transformations example (\#1624)”; “chore(examples): use the typed v3 surfaces with CLI-generated types (\#2009)”; and 2 more (refs \#2013, \#1624, \#2009, \#1619, \#1616).
examples/supabase/migrations · medium confidence · unverified
52 commits (21 fixes) modifying packages/supabase\_realtime/lib
A change to existing behaviour in packages/supabase\_realtime/lib — 52 commits (21 fixs), 21 files: “refactor(realtime)!: replace listener callbacks with streams (\#1706)”; “chore(release): publish packages (\#1841)”; “refactor(realtime)!: drop the legacy 1.0.0 protocol (\#1956)”; and 49 more (refs \#1706, \#1841, \#1956, \#1830, \#2076, …).
_packages/supabase\realtime/lib · medium confidence · unverified
55 commits (20 fixes) modifying packages/supabase\_typegen/lib/src
A change to existing behaviour in packages/supabase\_typegen/lib/src — 55 commits (20 fixs), 7 files: “feat(postgrest): type the embedded rows of a relation (\#1891)”; “fix(typegen): suffix a schema object named ArgumentError so the generated enums compile (\#1893)”; “feat(postgrest)!: carry primary keys and relation columns on PostgrestTable and emit them from typegen (\#1859)”; and 52 more (refs \#1891, \#1893, \#1859, \#1990, \#2001, …).
_packages/supabase\typegen/lib/src · medium confidence · unverified
6 commits (1 fix) modifying skills\_src/idioms
A change to existing behaviour in skills\_src/idioms — 6 commits (1 fix), 1 file: “refactor(supabase)!: client setup and options consistency before 3.0.0 (\#2021)”; “docs: fix README, MIGRATION.md and skill content that disagrees with the v3 code (\#2039)”; “fix(realtime)!: send broadcast data under payload without mutating the caller's map (\#2036)”; and 3 more (refs \#2021, \#2039, \#2036, \#2011, \#2118, …).
_skills\src/idioms · medium confidence · unverified
6 commits (3 fixes) modifying skills\_src/generate
A change to existing behaviour in skills\_src/generate — 6 commits (3 fixs), 1 file: “fix(typegen)!: stop renaming generated types that clash with supabase\_flutter and Flutter names (\#2047)”; “feat: ship agent skills with supabase\_flutter, supabase, supabase\_typegen and supabase\_test (\#2011)”; “fix(typegen): respect formatter settings on stdout and fail loudly on bad input (\#2023)”; and 3 more (refs \#2047, \#2011, \#2023, \#2118, \#2115, …).
_skills\src/generate · medium confidence · unverified
7 commits (0 fixes) modifying examples
A change to existing behaviour in examples — 7 commits, 6 files: “docs(examples): add Edge Functions example (\#1632)”; “feat(examples): add passkeys example with shared local Supabase setup and launcher (\#1407)”; “docs(examples): add Storage uploads and image transformations example (\#1624)”; and 4 more (refs \#1632, \#1407, \#1624, \#1627, \#2009, …).
examples · medium confidence · unverified
7 commits (2 fixes) modifying packages/supabase\_common/lib/src/postgres
A change to existing behaviour in packages/supabase\_common/lib/src/postgres — 7 commits (2 fixs), 13 files: “feat(typegen)!: read pg\_lsn and macaddr columns into value types (\#1994)”; “fix(postgrest)!: send DateTime filter operands with their offset from UTC (\#2024)”; “fix(typegen)!: suffix names that clash with SDK and Flutter types, and decode unknown enum labels and infinite timestamps (\#2044)”; and 4 more (refs \#1994, \#2024, \#2044, \#1998, \#1993, …).
_packages/supabase\common/lib/src/postgres · medium confidence · unverified
9 commits (2 fixes) modifying supabase
A change to existing behaviour in supabase — 9 commits (2 fixs), 4 files: “ci: move the test stack off the ephemeral port range (\#1810)”; “feat(auth): add signInWithWeb3 for Web3 wallet authentication (\#1590)”; “feat(storage): add vector buckets support (\#1585)”; and 6 more (refs \#1810, \#1590, \#1585, \#2020, \#1715, …).
supabase · medium confidence · unverified
Default HTTP client now keeps idle connections open for 60 seconds
The default HTTP transport used by the Supabase client now maintains idle connections for 60 seconds on \dart:io\ platforms (desktop and mobile) before closing them. This change reduces latency for subsequent requests by reusing existing TCP and TLS connections, aligning with the Supabase gateway's idle timeout behavior. On web platforms, the default browser-owned client remains unchanged.
_packages/supabase\common/lib/src/platform · high confidence
Functions client now supports idle timeouts and resolves access tokens per request
The \FunctionsClient\ in the \supabase\_functions\ package has been updated to support per-request idle timeouts, which restart whenever data is sent or received, and to automatically resolve an access token before every invocation via a provided callback. This ensures that rotating session tokens are correctly included in requests without requiring manual header management, while the new timeout mechanism allows for more granular control over request duration compared to a simple total timeout.
_packages/supabase\functions/lib/src · high confidence
New API key format support and trace context propagation
The Supabase client now recognizes the new \sb\publishable\\ and \sb\secret\\ API key formats, ensuring they are never sent as \Authorization: Bearer\ tokens (which are reserved for JWTs) and warning once if an unrecognized \sb\_\-prefixed key is used. Additionally, the client supports W3C trace context propagation, automatically attaching \traceparent\ headers to requests targeting Supabase hosts and correctly stripping them if a redirect leaves those hosts, while also allowing users to configure custom JSON codecs for realtime message encoding and decoding.
packages/supabase/lib/src · high confidence
PostgREST client rewritten with a typed builder API and enhanced type mappings
The PostgREST client has been refactored to support a new typed query builder surface. Users can now use \client.table()\ to perform type-safe operations where filters, ordering, and selections are compile-time checked against generated table schemas. This includes support for embedded relations, JSON path navigation, and aggregate functions within the typed API. Additionally, the client now provides explicit types for Postgres date, time, and interval columns (\PostgrestDate\, \PostgrestTime\, \PostgrestInterval\) and maps \bytea\ columns to \Uint8List\ for better binary data handling. The underlying request handling has also been updated to use a stateless builder pattern with configurable retry options and request timeouts.
packages/postgrest/lib/src · high confidence
Removal of supabase\_flutter.dart umbrella export
The main library entry point \lib/supabase\_flutter.dart\ has been removed, meaning users can no longer import the entire Supabase Flutter package via a single file. Previously, this file re-exported \src/supabase.dart\, \src/supabase\_auth\_state.dart\, \src/supabase\_deep\_linking\_mixin.dart\, and \src/supabase\_lifecycle\_state.dart\. Users must now import these specific modules individually or rely on other consolidated exports.
lib · high confidence
Repository restructured for v3 with new documentation and tooling
The repository has been reorganized to support the upcoming v3 release, introducing a monorepo structure managed by Melos. This includes renaming core packages (e.g., \gotrue\ to \supabase\_auth\, \storage\_client\ to \supabase\_storage\) and moving the Iceberg catalog into its own \iceberg\ package. A comprehensive migration guide (\MIGRATION.md\) has been added to help users transition from v2, detailing breaking changes such as the requirement for \publishableKey\ instead of \anonKey\, updated return types for auth methods, and new type mappings in the type generator. Additionally, new tooling files like \.coderabbit.yaml\ and \.sdk-parse-ignore\ have been introduced to support code review automation and SDK capability matrix scanning.
(repo-wide) · high confidence
Supabase Flutter v3.0.0 introduces pluggable OAuth, granular realtime lifecycle control, and passkey support
This release upgrades the package to version 3.0.0-dev.8, bringing several key behavioral changes. Authentication flows are now customizable via a pluggable \OAuthLauncher\ interface, allowing developers to replace the default browser launch with system web authentication sessions. Session persistence has been consolidated into a new \SharedPreferencesAuthAsyncStorage\ that automatically migrates legacy v2 data and uses \window.localStorage\ on web to share state with supabase-js. The realtime socket lifecycle is now configurable via \RealtimeLifecycleOptions\, enabling users to delay disconnection during short app pauses or manage the socket manually. Additionally, the package adds experimental support for Passkeys (WebAuthn) and Android Restore Credentials, and ensures proper cleanup of WebSocket connections and broadcast channels during Flutter web hot-restarts.
_packages/supabase\flutter/lib/src · high confidence
Supabase client library v3 restructure and API overhaul
The Supabase client library has been updated to version 3, introducing a comprehensive restructuring of the public API. Deprecated APIs and dead code have been removed, and several sub-packages have been renamed for consistency: \gotrue\ is now \supabase\_auth\, \storage\_client\ is \supabase\_storage\, \realtime\_client\ is \supabase\_realtime\, and \functions\_client\ is \supabase\_functions\. The library now exports these renamed packages alongside \postgrest\. New capabilities include typed table access via \PostgrestTable\ and \TableColumn\, opt-in trace context propagation headers, and a new \SupabaseClientPlugin\ architecture. Additionally, multiple stream filters are now disallowed to simplify usage, and a single \HttpMethod\ enum is shared across packages.
packages/supabase/lib · high confidence
Updated example app Android native configuration and Gradle wrapper
The Android example app's native configuration has been updated to align with modern Flutter standards. The Gradle wrapper has been upgraded to version 9.3.1, and the AndroidManifest.xml now explicitly declares the INTERNET permission for debug and profile builds to support hot reload and debugging. Additionally, the app now includes a \<queries\> block to handle text processing intents, and the Android embedding version is explicitly set to 2 in the manifest.
_packages/supabase\flutter/example/android · high confidence
Updated example app to use publishable key and handle auth stream errors
The Supabase Flutter example application has been updated to reflect recent API changes. It now initializes the client using the new \publishableKey\ parameter instead of the previous \anonKey\, and includes a required \onError\ handler in the \onAuthStateChange\ stream listener to prevent unhandled exceptions during network failures.
_packages/supabase\flutter/example/lib · high confidence
Updated iOS example project to support iOS 13+ and modern Xcode configurations
The iOS example app for supabase\_flutter has been regenerated to align with current Flutter tooling standards. The minimum deployment target is now iOS 13.0, and the project includes updated Xcode workspace and scheme configurations, a standard Swift AppDelegate, and a basic test target to ensure the example builds and runs correctly out of the box.
_packages/supabase\flutter/example/ios · high confidence
YAJsonIsolate now processes JSON via AsyncJsonCodec with adaptive isolate usage
The library has been refactored to route all JSON encoding and decoding through the new \AsyncJsonCodec\ interface, allowing users to supply custom implementations (e.g., for native parsers or instrumentation). On the IO platform, the implementation now uses an adaptive strategy: small payloads (under 64 KB) are processed inline to avoid isolate overhead, while large payloads are offloaded to short-lived isolates to prevent blocking the main event loop. The web platform variant continues to process all work inline, as isolates are not available. The public API remains compatible, but the internal architecture has shifted from a persistent isolate model to this on-demand, size-aware approach.
_packages/yet\_another\_json\isolate/lib · high confidence
Fixes
3 commits (2 fixes) fixing packages/supabase\_flutter\_web\_auth/example
A fix in packages/supabase\_flutter\_web\_auth/example — 3 commits (2 fixs), 4 files: “fix(supabase\_flutter\_web\_auth)!: report a cancelled sign-in without throwing (\#2018)”; “feat(supabase\_flutter): pluggable OAuth launcher + opt-in supabase\_flutter\_web\_auth (\#1807)”; “fix(auth)!: align signOut with the sign-out spec (\#2111)” (refs \#2018, \#1807, \#2111).
_packages/supabase\_flutter\_web\auth/example · medium confidence · unverified
5 commits (3 fixes) fixing skills\_src/auth-setup
A fix in skills\_src/auth-setup — 5 commits (3 fixs), 1 file: “docs: fix README, MIGRATION.md and skill content that disagrees with the v3 code (\#2039)”; “feat: ship agent skills with supabase\_flutter, supabase, supabase\_typegen and supabase\_test (\#2011)”; “fix(auth)!: signOut must not report success when the server revoke was skipped or lost (\#2053)”; and 2 more (refs \#2039, \#2011, \#2053, \#2111, \#2110).
_skills\src/auth-setup · medium confidence · unverified
6 commits (4 fixes) fixing skills\_src/realtime
A fix in skills\_src/realtime — 6 commits (4 fixs), 1 file: “docs: fix README, MIGRATION.md and skill content that disagrees with the v3 code (\#2039)”; “fix(realtime)!: send broadcast data under payload without mutating the caller's map (\#2036)”; “feat: ship agent skills with supabase\_flutter, supabase, supabase\_typegen and supabase\_test (\#2011)”; and 3 more (refs \#2039, \#2036, \#2011, \#2030, \#2051, …).
_skills\src/realtime · medium confidence · unverified
9 commits (5 fixes) fixing examples/authentication
A fix in examples/authentication — 9 commits (5 fixs), 9 files: “test(examples): add end-to-end tests for the authentication example (\#1628)”; “docs(examples): add authentication example covering all sign in methods (\#1627)”; “fix(examples): make the setup SQL safe, keep realtime room messages and create auth streams once (\#2040)”; and 6 more (refs \#1628, \#1627, \#2040, \#1705, \#2035, …).
examples/authentication · medium confidence · unverified
Test coverage
12 commits adding/updating tests in packages/iceberg/test; 2 commits adding/updating tests in examples/realtime\_room/test; 3 commits adding/updating tests in packages/supabase\_flutter\_web\_auth/test; 33 commits adding/updating tests in packages/supabase\_common/test; 38 commits adding/updating tests in packages/supabase\_realtime/test; 38 commits adding/updating tests in packages/supabase\_typegen/test/goldens; 4 commits adding/updating tests in packages/supabase\_auth/test/browser; 4 commits adding/updating tests in skills\_src/testing; 5 commits adding/updating tests in examples/database\_crud/integration\_test; 50 commits adding/updating tests in packages/supabase\_typegen/test; 7 commits adding/updating tests in packages/supabase\_common/test/postgres; Added comprehensive test suite for Supabase Storage client; Added comprehensive test suite for yet\_another\_json\_isolate; Added local stack test configuration constants; Added test coverage for Supabase client features; Added tests for FunctionsClient HTTP handling and error scenarios; Added tests for authentication type models; Added tests for the supabase\_test mocking library; Expanded test coverage for PostgREST client capabilities; Expanded test coverage for Supabase Auth admin and session management; Expanded test coverage for supabase\_auth package; Expanded test coverage for supabase\_flutter initialization, auth, and lifecycle; Removed obsolete Supabase singleton initialization test.
Dependencies
Migrate to Dart 3.9 and Melos workspaces
The Supabase Flutter SDK has been upgraded to require Dart 3.9.0 and Flutter 3.35.0, aligning with the latest language features and platform support. The monorepo has been restructured to use Melos workspaces, which standardizes dependency management across all packages (such as supabase\_flutter, supabase\_auth, and postgrest) and examples. This change also updates the minimum supported Android NDK to Java 17 and Kotlin 2.4.0, and refreshes the iOS/macOS platform targets to iOS 16.0 and macOS 13.5.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.
Score
- CAI 66 → 59 (-7.0)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 87 → 89 (+1.4)
- Architecture 98 → 97 (-1.0)
- Maturity 61 → 63 (+2.4)
- Readiness 63 → 63 (+0.0)
- Security 65 → 46 (-19.0)
- Domain Modelling 100 → 100 (+0.0)
- Performance 78 → 78 (+0.0)
Resolved (9)
- Documentation: no project overview (README.md)
- Documentation: written for insiders (packages/supabase_test/README.md)
- Duplicated block (17 lines × 2) (packages/supabase_flutter/example/lib/main.dart)
- Hotspot: packages/supabase/lib/src/supabase_typed_stream_builder.dart (packages/supabase/lib/src/supabase_typed_stream_builder.dart)
- Hotspot: packages/supabase_flutter/lib/src/supabase.dart (packages/supabase_flutter/lib/src/supabase.dart)
- Off-boarding risk: anonymized user #1
- PostgrestInterval._parseUnitWords (cyclomatic 18) (packages/postgrest/lib/src/postgrest_interval.dart)
- Repeated repair: examples/database_crud/lib/main.dart (examples/database_crud/lib/main.dart)
- Supabase._processLifecycle (cyclomatic 16) (packages/supabase_flutter/lib/src/supabase.dart)
New (28)
- Boundary-crossing change coupling: postgrest_builder.dart ↔ json_isolate_io.dart (packages/postgrest/lib/src/postgrest_builder.dart)
- Boundary-crossing change coupling: supabase_client.dart ↔ flutter_auth_client_options.dart (packages/supabase/lib/src/supabase_client.dart)
- Boundary-crossing change coupling: supabase_client.dart ↔ supabase_realtime.dart (packages/supabase/lib/src/supabase_client.dart)
- Boundary-crossing change coupling: types.dart ↔ types.dart (packages/postgrest/lib/src/types.dart)
- ClassTooLong: IcebergRestCatalog (packages/iceberg/lib/src/iceberg_rest_catalog.dart)
- Duplicated block (10 lines × 2) (packages/supabase_flutter/example/lib/main.dart)
- FileTooLong: src/fetch.dart (packages/supabase_storage/lib/src/fetch.dart)
- FileTooLong: src/generator_metadata_parser.dart (packages/supabase_typegen/lib/src/generator_metadata_parser.dart)
- FileTooLong: src/iceberg_rest_catalog.dart (packages/iceberg/lib/src/iceberg_rest_catalog.dart)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- Hotspot: packages/postgrest/lib/src/postgrest_table_executor.dart (packages/postgrest/lib/src/postgrest_table_executor.dart)
- Hotspot: packages/supabase_storage/lib/src/resumable_upload.dart (packages/supabase_storage/lib/src/resumable_upload.dart)
- Hotspot: packages/supabase_test/lib/src/mock_realtime_transport.dart (packages/supabase_test/lib/src/mock_realtime_transport.dart)
- Leaked secret: private-key (supabase/signing_keys.json)
- Low cohesion: PostgrestEmbeddedCount (LCOM4 4) (packages/postgrest/lib/src/postgrest_embedded_relation.dart)
- Off-boarding risk: anonymized user #1
- …and 8 more
Changes since last survey
- 136 commits — 65 feature/other, 71 fixes
By area
- packages/postgrest — 23 commits
- packages/supabase_auth — 20 commits
- packages/supabase — 15 commits
- packages/supabase_typegen — 13 commits
- packages/supabase_realtime — 12 commits
- packages/supabase_flutter — 9 commits
- packages/supabase_storage — 9 commits
- (root) — 7 commits
- .github/workflows — 6 commits
- examples/realtime_room — 4 commits
- packages/supabase_common — 4 commits
- packages/iceberg — 3 commits
- packages/supabase_flutter_web_auth — 2 commits
- packages/supabase_functions — 2 commits
- packages/supabase_test — 2 commits
- packages/yet_another_json_isolate — 2 commits
- (repo) — 1 commit
- .github/dependabot.yml — 1 commit
- examples/authentication — 1 commit
Notable commits
- fix: ci: run the supabase_test suite in CI and fix its four failing tests (#2017)
- fix: fix(auth)!: align signOut with the sign-out spec (#2111)
- fix: fix(auth)!: harden PKCE verifiers, redirectType, signOut and dispose edge cases (#2027)
- fix: fix(auth)!: judge session expiry from the time the device received it (#2123)
- fix: fix(auth)!: refresh user-scoped tokens, keep restored sessions and announce user switches as signedIn (#2037)
- fix: fix(auth)!: signOut must not report success when the server revoke was skipped or lost (#2053)
- fix: fix(auth): align getClaims and ErrorCode with the canonical spec (#2099)
- fix: fix(auth): check the token header algorithm against the matched JWK in getClaims (#2091)
- fix: fix(auth): drop the error handling for servers without error codes and dead JWT rethrows (#2077)
- fix: fix(auth): emit a sessionMissing sign out for an unreadable stored session at startup (#2107)
- fix: fix(auth): fail a global or others sign out answered with session_not_found (#2108)
- fix: fix(auth): honor allowExpired when verifying asymmetric tokens in getClaims (#2094)
- fix: fix(auth): keep PKCE verifiers when an email response is malformed (#2096)
- fix: fix(auth): keep the session when a refresh is rate limited or answered by a proxy (#2033)
- fix: fix(auth): read decoded JSON through JsonFields (#2086)
- fix: fix(auth): sign out as asked when a global or others sign out finds the refresh token rejected (#2110)
- fix: fix(examples): correct the realtime room delete payload comments (#2013)
- fix: fix(examples): make the setup SQL safe, keep realtime room messages and create auth streams once (#2040)
- fix: fix(functions): keep a query string in the function name when adding query parameters (#2120)
- fix: fix(iceberg)!: parse Supabase error bodies, add timeout and abort, and stop swallowing config errors (#2038)
- …and 116 more
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
supabase/supabase-flutter was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 5 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit c5953f73f3fd5be62e00eb3b8be5b259b3aa6a8a — the exact code this score is about.
- Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.2+preprod-5c4e66d9318b.