Skip to content
CAI
Software that uses CAICheck a score

supabase/supabase-swift

67.4

Adequate · 15 November 2026

57.3k

lines of production code

Swift

primary language

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add UserManagement example app for Swift

The UserManagement example application is now available, demonstrating how to build a cross-platform (iOS and macOS) SwiftUI app with Supabase. It includes full authentication flows using OTP magic links with deep linking support, user profile management (reading, updating, and deleting accounts), and avatar image handling via Supabase Storage. The example also provides the necessary Supabase project configuration, including database migrations for a profiles table with Row Level Security policies and storage bucket setup.

Examples/UserManagement · high confidence

Add example Supabase Edge Functions for chat, hello-world, and uploads

The Examples app now includes three new Supabase Edge Functions to demonstrate server-side capabilities: a 'chat' function that streams a canned reply word-by-word using Server-Sent Events (eliminating the need for an external AI API key), a 'hello-world' function that returns a simple JSON greeting, and an 'upload' function that reads a streamed request body and reports its size and content type. These additions allow users to test and integrate these specific serverless patterns within the example application.

Examples/supabase/functions · high confidence

Add shared Xcode workspace and module-specific schemes

The repository now includes a shared Xcode workspace (Supabase.xcworkspace) that aggregates the library targets (Auth, Functions, PostgREST, Realtime, Storage, Supabase) and the Examples project. This change introduces individual, shared schemes for each module, allowing developers to build, test, profile, and archive specific libraries independently. The main Supabase scheme is configured to build all modules and run tests with code coverage enabled, while individual module schemes (like Auth and PostgREST) are set up to run their respective tests and generate coverage reports, improving the local development and CI experience.

Supabase.xcworkspace · high confidence

Added Xcode schemes for Examples, SlackClone, and UserManagement apps

The Examples project now includes dedicated Xcode schemes for the Examples, SlackClone, and UserManagement sample applications. These schemes configure the build, test, launch, profile, analyze, and archive actions for each app, enabling developers to easily run and debug the individual sample apps directly from Xcode.

Examples/Examples.xcodeproj/xcshareddata · high confidence

Added Xcode workspace configuration files

The Examples project now includes the standard Xcode workspace structure, specifically the \contents.xcworkspacedata\ file defining the workspace root and the \IDEWorkspaceChecks.plist\ file to suppress the 32-bit warning. This ensures the workspace is correctly recognized and configured by Xcode for the example project.

Examples/Examples.xcodeproj/project.xcworkspace · high confidence

Comprehensive UX overhaul of the Examples app with inline code documentation

The Examples app has been redesigned to provide a comprehensive user experience, featuring a new tabbed navigation structure (Database, Realtime, Storage, Functions, Profile) and a unified authentication flow. This update introduces a reusable \ActionState\ view for managing async UI states (idle, loading, success, failure with retry) and adds detailed inline code examples within the UI, such as in the new Multi-Factor Authentication (MFA) enrollment flow. The app now includes specific examples for third-party authentication integrations like Clerk, MetaMask, Google Sign-In, and Facebook, along with a password recovery flow and improved error handling via a dedicated \ErrorText\ component.

Examples/Examples · high confidence

Initial Supabase database schema and storage policies

The example application now includes a database migration that creates a \todos\ table with row-level security policies restricting access to the record owner, along with storage policies that allow authenticated users to create buckets and upload or list objects.

Examples/supabase/migrations · high confidence

Initial Supabase local development configuration for Swift examples

The Examples/supabase directory now includes a standard Supabase local development setup, providing a config.toml that initializes the local API, database (PostgreSQL 15), Studio, and email testing services on specific ports. The configuration enables anonymous sign-ins, manual account linking, and WebAuthn/passkey authentication, while also defining external OAuth providers for GitHub and Apple. A .gitignore file is added to exclude local state files, and an empty seed.sql is provided for database initialization.

Examples/supabase · high confidence

Initial Supabase local development environment and example schema

This change introduces the foundational configuration and database schema for the Supabase local development environment. It adds a \.gitignore\ to exclude local artifacts, a \config.toml\ defining the local service ports and enabled features (API, Database, Studio, Auth, Storage, Realtime), and SQL migrations that establish the \key\_value\_storage\, \todos\, \profiles\, and \messages\ tables with appropriate Row Level Security policies. Additionally, it includes a \seed.sql\ file with helper functions to populate sample data for the examples app, enabling immediate testing of CRUD operations, realtime subscriptions, and storage features locally.

supabase · high confidence

Introduce Swift supabase-typegen tool for generating @Table structs

A new SwiftPM package at tools/supabase-typegen provides the supabase-typegen executable, which reads a GeneratorMetadata document and emits Swift source code containing @Table structs for database relations, enums, and computed fields. The tool maps Postgres types to specific Swift types (including \_PostgresRange variants for range types and \_PostgresUnmapped for unmapped types), handles schema selection, and manages naming conflicts by emitting notes to standard error. This location contains the generator implementation, its command-line interface, and the associated tests and fixtures. Also in this area: 1 commit (0 fixes) modifying tools.

tools/supabase-typegen/Tests · medium confidence · unverified

Introduce typed query API with compile-time safe macros

This change introduces the PostgrestMacros module, providing a new typed query API for PostgREST. Users can now use the @Table macro to define Swift structs that map to database relations, automatically generating column mappings, primary key handling, and a Columns namespace for type-safe filtering and ordering. The API includes marker macros like @PrimaryKey, @Default, and @Generated to control insert/update behavior and handle database defaults or generated columns. Additionally, @Relationship allows defining embedded relations with foreign keys or computed relationships, ensuring compile-time safety for joins and preventing ambiguous PostgREST responses. The typed API is gated behind @\_spi(Experimental) and requires explicit opt-in.

Sources/PostgrestMacros · high confidence

Introduce typed relation and selection protocols for compile-time safety

The PostgREST client now uses a new type-safe system for defining database relations and selections. This introduces \PostgrestRelation\ and \PostgrestSelection\ protocols, allowing developers to define tables and views with explicit schema associations (e.g., \PublicSchema\ or custom schemas) and column namespaces. This enables compile-time checks to prevent querying relations from the wrong schema and provides a structured way to build filters and selections using column properties rather than raw strings. Additionally, \PostgrestWritableRelation\ defines a \Draft\ type for inserts/upserts, replacing the previous \Insert\ shape to better support upsert operations and nullable column handling.

Sources/PostgREST/Relations · high confidence

Introduces experimental typed query and mutation API

Adds a new, opt-in typed query API (available via \@\_spi(Experimental)\) that replaces string-based table and column names with compile-time-checked types. This change introduces a structured query builder supporting \where\, \order\, \limit\, and \range\ filters, as well as \single()\ and \maybeSingle()\ result modifiers. It also adds typed mutations (\insert\, \update\, \delete\, \upsert\) with phase-based safety (e.g., requiring a filter for updates/deletes) and support for embedded relationships with scoped filtering. The API is gated behind an experimental SPI to allow for future shape changes.

Sources/PostgREST/Query · high confidence

Introduces typed column expressions, aggregates, and Postgres-specific value types

The \Sources/PostgREST/Columns\ module now provides a type-safe column expression system that replaces string-based tokens with a structured filter tree. Users can now use casts (e.g., \cast(to: .text)\), JSON path extraction (e.g., \`jsonText(

Sources/PostgREST/Columns · high confidence

New Admin API for user, MFA, and OAuth client management

The Auth module now exposes a dedicated \AuthAdmin\ client for server-side operations that require the secret key. This new API provides methods to create, update, delete, and list users (including an \AsyncSequence\ paginator for efficient bulk iteration), manage user multi-factor authentication factors (list and delete), and administer OAuth 2.1 client registrations (list, create, update, delete, and secret regeneration). These capabilities are accessed via the \admin\ namespace on the main \AuthClient\ or through a standalone \AuthAdmin\ initializer, enabling administrators to manage project users and OAuth configurations directly from secure backend environments.

Sources/Auth · high confidence

New Examples project structure with integrated sample apps

The Examples project has been restructured to include dedicated sample applications for User Management and a Slack Clone, alongside a main Examples app. This change introduces new source files and framework dependencies, including Clerk for third-party authentication, GoogleSignIn, FacebookLogin, and metamask-ios-sdk, enabling users to explore these specific integration patterns directly within the project.

Examples/Examples.xcodeproj · high confidence

New Helpers module with HTTP transport types and API key validation

A new Sources/Helpers module has been added, introducing the HTTPTypes and HTTPTypesFoundation libraries to replace the previous internal HTTPRequest/HTTPResponse types, and providing a new APIKeyFormat utility that classifies Supabase API keys and prevents new-format keys (sb\publishable\/sb\secret\) from being incorrectly sent as Bearer tokens. The module also includes foundational helpers such as Base64URL encoding/decoding, JWT decoding, PostgREST filter value escaping, date formatting, and an EventEmitter for managing observations.

Sources/Helpers · high confidence

New Profile management example with identity and security features

Added a new Profile example section demonstrating user profile management, including viewing account details, updating email/phone/password with verification flows, managing linked social identities (OAuth), and configuring security settings like Multi-Factor Authentication and WebAuthn passkeys. Also in this area: 1 commit (0 fixes) modifying Examples, Examples/Reminders, Sources.

Examples/Examples/Profile · low confidence · unverified

New Storage example app with bucket and file management UIs

The Examples app now includes a comprehensive Storage section featuring dedicated SwiftUI views for managing buckets (listing, creating, updating, deleting) and files (uploading with progress, downloading with preview, moving, copying, deleting, searching, and transforming images). It also demonstrates advanced capabilities like resumable (tus) uploads with pause/resume/cancel and persistence across app relaunches, as well as generating signed URLs for temporary access and uploads.

Examples/Examples/Storage · high confidence

Storage client rewritten with streaming downloads, resumable uploads, and typed APIs

The Storage library has been rebuilt to use modern Swift concurrency and streaming. Downloads now return a \DownloadResponse\ that streams the object body, allowing large files to be written to disk without loading them into memory. Resumable uploads (Tus protocol) are introduced as an experimental feature, supporting pause, resume, cancellation, and persistence across app relaunches via \ResumableStore\. The API is now fully typed: \StorageBucket\ replaces \StorageFileApi\, \StorageClient\ replaces \SupabaseStorageClient\, and options like \UploadOptions\ and \ObjectListingOptions\ replace previous untyped dictionaries. Listing objects is now an \AsyncSequence\ via \objects(prefix:options:)\, and signed URLs use \Duration\ for expiration.

Sources/Storage · high confidence

Typed filter API with compile-time safety and new operators

The PostgREST filter API is now fully typed, replacing string-based column references with compiler-checked expressions that prevent invalid operator-column combinations (e.g., using array operators on text columns). This update introduces support for comparison operators (\eq\, \neq\, \gt\, \gte\, \lt\, \lte\, \isDistinct\), pattern matching (\like\, \ilike\, \regexMatch\, \regexIMatch\, \likeAnyOf\, \ilikeAnyOf\), and specialized operators for array (\contains\, \containedBy\, \overlaps\), range (\containsRange\, \rangeLt\, \rangeGt\, \rangeGte\, \rangeLte\, \rangeAdjacent\), and JSON (\containsJSON\, \containedByJSON\) columns. It also adds full-text search (\textSearch\), null checks (\isNull\), and boolean checks (\isTrue\, \isFalse\). Users can now use standard Swift comparison operators (\==\, \!=\, \\<\, \\>\, \\<=\, \\>=\) as syntactic sugar for the corresponding methods. The API accepts \Decimal\, \Float\, and sized integers as filter values, and provides a \raw\ escape hatch for unsupported operators while maintaining column type safety.

Sources/PostgREST/Filters · high confidence

Behavioural changes

1 commit (0 fixes) modifying (repo-wide)

A change to existing behaviour in (repo-wide) — 1 commit, 10 files: “refactor(examples): migrate Reminders to supabase-swift v3 (\#1816)” (refs \#1816).

(repo-wide) · medium confidence · unverified

100 commits (27 fixes) modifying Sources/Realtime

A change to existing behaviour in Sources/Realtime — 100 commits (27 fixs), 53 files: “feat(realtime)!: fold RealtimeError.Kind.connection into transport (\#1407)”; “feat(realtime)!: adopt Duration for the remaining TimeInterval intervals (\#1401)”; “test(realtime): add StubWebSocketTransport and an in-memory FakeRealtimeServer (\#1456)”; and 97 more (refs \#1407, \#1401, \#1456, \#1459, \#1658, …).

Sources/Realtime · medium confidence · unverified

11 commits (2 fixes) modifying tools/supabase-typegen/Sources

A change to existing behaviour in tools/supabase-typegen/Sources — 11 commits (2 fixs), 8 files: “feat(typegen): generate client.rpc methods that call the typed rpc (\#1731)”; “chore(release): keep copyable version strings, library list, and migration headings in sync (\#1752)”; “feat(postgrest): map each Postgres type to one Swift type in the typegen (\#1519)”; and 8 more (refs \#1731, \#1752, \#1519, \#1758, \#1492, …).

tools/supabase-typegen/Sources · medium confidence · unverified

12 commits (2 fixes) modifying Sources/Auth/Internal/Persistence

A change to existing behaviour in Sources/Auth/Internal/Persistence — 12 commits (2 fixs), 5 files: “feat(auth)!: add v3 user, identity, and claims calls with a per-client JWKS cache (\#1684)”; “refactor(auth): add a versioned persisted session format with one-time migration (\#1626)”; “feat(auth)!: flatten the MFA API and make MFA values open-set structs (\#1686)”; and 9 more (refs \#1684, \#1626, \#1686, \#1757, \#1781, …).

Sources/Auth/Internal/Persistence · medium confidence · unverified

17 commits (5 fixes) modifying Sources/PostgREST/Request

A change to existing behaviour in Sources/PostgREST/Request — 17 commits (5 fixs), 1 file: “refactor!: code: \<Module\>Error.Code? in every error, and one open-set shape (\#1767)”; “refactor!: one field layout for response wrappers (status, headers, body, requestID) (\#1755)”; “fix(postgrest): surface a throwing access-token provider as a PostgrestError (\#1465)”; and 14 more (refs \#1767, \#1755, \#1465, \#1779, \#1760, …).

Sources/PostgREST/Request · medium confidence · unverified

19 commits (2 fixes) modifying Sources/Auth/WebAuthn

A change to existing behaviour in Sources/Auth/WebAuthn — 19 commits (2 fixs), 6 files: “fix(auth,storage,realtime,helpers)!: narrow Codable conformances to their actual usage direction (\#1209)”; “refactor!: code: \<Module\>Error.Code? in every error, and one open-set shape (\#1767)”; “feat(auth)!: flatten the MFA API and make MFA values open-set structs (\#1686)”; and 16 more (refs \#1209, \#1767, \#1686, \#1406, \#1357, …).

Sources/Auth/WebAuthn · medium confidence · unverified

19 commits (3 fixes) modifying Sources/PostgrestMacrosPlugin/Support

A change to existing behaviour in Sources/PostgrestMacrosPlugin/Support — 19 commits (3 fixs), 4 files: “feat(postgrest): add @Relationship and embeds in selections (\#1307)”; “refactor(typegen)!: emit ID, URL, URI, JWT and OTP in uppercase (\#1758)”; “refactor(postgrest): rename the generated Insert shape to Draft (\#1286)”; and 16 more (refs \#1307, \#1758, \#1286, \#1488, \#1259, …).

Sources/PostgrestMacrosPlugin/Support · medium confidence · unverified

2 commits (0 fixes) modifying Examples, Examples/Reminders

A change to existing behaviour in Examples, Examples/Reminders — 2 commits, 65 files: “refactor(examples): migrate Reminders to supabase-swift v3 (\#1816)”; “refactor(examples): adopt the typed query API, typegen and typed Realtime in Reminders (\#1817)” (refs \#1816, \#1817).

Examples/Reminders · medium confidence · unverified

22 commits (3 fixes) modifying Examples/SlackClone

A change to existing behaviour in Examples/SlackClone — 22 commits (3 fixs), 14 files: “feat(realtime)!: add BroadcastMessage, PostgresChange, PostgresRow and lazy TypedPostgresChange (\#1658)”; “feat!: throw from client initializers on an invalid configuration (\#1762)”; “feat(realtime)!: status enums with reasons, channel events, heartbeat events (\#1655)”; and 19 more (refs \#1658, \#1762, \#1655, \#559, \#214, …).

Examples/SlackClone · medium confidence · unverified

23 commits (3 fixes) modifying Examples/Examples/Realtime

A change to existing behaviour in Examples/Examples/Realtime — 23 commits (3 fixs), 9 files: “feat(realtime)!: add BroadcastMessage, PostgresChange, PostgresRow and lazy TypedPostgresChange (\#1658)”; “fix(realtime): resolve race conditions and connection bugs (\#866)”; “feat(realtime)!: status enums with reasons, channel events, heartbeat events (\#1655)”; and 20 more (refs \#1658, \#866, \#1655, \#1778, \#1663, …).

Examples/Examples/Realtime · medium confidence · unverified

23 commits (3 fixes) modifying Sources/TestHelpers

A change to existing behaviour in Sources/TestHelpers — 23 commits (3 fixs), 15 files: “feat(realtime): add the RealtimeEngine actor with supervisor, serial writer and fan-out (\#1459)”; “chore(android): cross-compile and test the SDK on Android (\#1415)”; “chore!: enable NonisolatedNonsendingByDefault for every SDK target (\#1429)”; and 20 more (refs \#1459, \#1415, \#1429, \#1351, \#1655, …).

Sources/TestHelpers · medium confidence · unverified

24 commits (6 fixes) modifying Sources/PostgREST/Untyped

A change to existing behaviour in Sources/PostgREST/Untyped — 24 commits (6 fixs), 8 files: “feat(postgrest): deprecate the filter aliases on the untyped builder (\#1466)”; “refactor!: code: \<Module\>Error.Code? in every error, and one open-set shape (\#1767)”; “refactor(helpers)!: keep a JSON number's exact digits in JSONValue (\#1790)”; and 21 more (refs \#1466, \#1767, \#1790, \#1762, \#1755, …).

Sources/PostgREST/Untyped · medium confidence · unverified

27 commits (6 fixes) modifying Sources/PostgrestMacrosPlugin

A change to existing behaviour in Sources/PostgrestMacrosPlugin — 27 commits (6 fixs), 5 files: “fix(postgrest): close the typed upsert's missing conflict target (\#1283)”; “feat(postgrest): add @Relationship and embeds in selections (\#1307)”; “feat(postgrest)!: name a relation's schema with a type (\#1372)”; and 24 more (refs \#1283, \#1307, \#1372, \#1286, \#1488, …).

Sources/PostgrestMacrosPlugin · medium confidence · unverified

3 commits (0 fixes) modifying Examples/UserManagement/supabase

A change to existing behaviour in Examples/UserManagement/supabase — 3 commits, 4 files: “feat: add AdminAPI and deleteUser method (\#224)”; “ci: migrate test config to supabase cli v3 (\#1700)”; “docs: use user id when storing user's avatar image (\#228)” (refs \#224, \#1700, \#228).

Examples/UserManagement/supabase · medium confidence · unverified

3 commits (0 fixes) modifying Sources/Auth/State

A change to existing behaviour in Sources/Auth/State — 3 commits, 1 file: “feat(auth): add AuthModel, an @Observable mirror of the auth status for SwiftUI (\#1713)”; “refactor: one app-lifecycle stream in Helpers for Auth and Realtime (\#1754)”; “feat(auth)!: clean up Configuration and use Date and Duration in the public model (\#1718)” (refs \#1713, \#1754, \#1718).

Sources/Auth/State · medium confidence · unverified

30 commits (2 fixes) modifying Examples/Examples/Auth

A change to existing behaviour in Examples/Examples/Auth — 30 commits (2 fixs), 17 files: “feat(auth)!: add v3 user, identity, and claims calls with a per-client JWKS cache (\#1684)”; “feat: add Sendable conformances and fix warnings (\#260)”; “feat(auth): add \signInWithOAuth\ (\#299)”; and 27 more (refs \#1684, \#260, \#299, \#1139, \#1686, …).

Examples/Examples/Auth · medium confidence · unverified

4 commits (0 fixes) modifying Examples/Examples/Database

A change to existing behaviour in Examples/Examples/Database — 4 commits, 5 files: “feat(examples): comprehensive UX overhaul with inline code examples (\#819)”; “refactor(postgrest)!: make client and builders stateless value types (\#1240)”; “chore: remove redundant comments across the repo (\#1586)”; and 1 more (refs \#819, \#1240, \#1586, \#1739).

Examples/Examples/Database · medium confidence · unverified

4 commits (0 fixes) modifying Sources/Auth/Internal/JWT

A change to existing behaviour in Sources/Auth/Internal/JWT — 4 commits, 3 files: “feat(auth)!: add v3 user, identity, and claims calls with a per-client JWKS cache (\#1684)”; “chore(deps)!: require swift-crypto 4.0.0 and its CryptoExtras product (\#1687)”; “feat(auth)!: clean up Configuration and use Date and Duration in the public model (\#1718)”; and 1 more (refs \#1684, \#1687, \#1718, \#1738).

Sources/Auth/Internal/JWT · medium confidence · unverified

4 commits (1 fix) modifying Examples/SlackClone/supabase

A change to existing behaviour in Examples/SlackClone/supabase — 4 commits (1 fix), 4 files: “ci: migrate test config to supabase cli v3 (\#1700)”; “chore(docs): cleanup SlackClone example (\#559)”; “refactor: Realtime V2 (\#214)”; and 1 more (refs \#1700, \#559, \#214, \#470).

Examples/SlackClone/supabase · medium confidence · unverified

5 commits (0 fixes) modifying Examples/Examples/Functions

A change to existing behaviour in Examples/Examples/Functions — 5 commits, 3 files: “docs(functions): add the Functions.docc catalog, integration suite, example screens and compliance rows (Phase 4) (\#1448)”; “feat(examples): comprehensive UX overhaul with inline code examples (\#819)”; “chore: remove redundant comments across the repo (\#1586)”; and 2 more (refs \#1448, \#819, \#1586, \#1443, \#1739).

Examples/Examples/Functions · medium confidence · unverified

6 commits (1 fix) modifying Sources/Helpers/SharedModels

A change to existing behaviour in Sources/Helpers/SharedModels — 6 commits (1 fix), 2 files: “feat!: throw from client initializers on an invalid configuration (\#1762)”; “refactor!: one field layout for response wrappers (status, headers, body, requestID) (\#1755)”; “feat(helpers): add SupabaseError root and HTTPErrorResponse (\#1333)”; and 3 more (refs \#1762, \#1755, \#1333, \#1338, \#1775, …).

Sources/Helpers/SharedModels · medium confidence · unverified

8 commits (0 fixes) modifying Examples/OpenTelemetryDemo

A change to existing behaviour in Examples/OpenTelemetryDemo — 8 commits, 2 files: “feat!: throw from client initializers on an invalid configuration (\#1762)”; “refactor!: align the public API with the Swift API Design Guidelines (\#1355)”; “refactor!: one client configuration shape across all modules (\#1760)”; and 5 more (refs \#1762, \#1355, \#1760, \#1637, \#1101, …).

Examples/OpenTelemetryDemo · medium confidence · unverified

8 commits (4 fixes) modifying Sources/PostgREST

A change to existing behaviour in Sources/PostgREST — 8 commits (4 fixs), 2 files: “refactor!: code: \<Module\>Error.Code? in every error, and one open-set shape (\#1767)”; “feat!: throw from client initializers on an invalid configuration (\#1762)”; “fix!: shared error kinds, and wrap every client-side refusal as \.invalidRequest\ (\#1778)”; and 5 more (refs \#1767, \#1762, \#1778, \#1779, \#1775, …).

Sources/PostgREST · medium confidence · unverified

Auth module refactored with new internal architecture and concurrent PKCE support

The internal Auth module has been restructured to support concurrent PKCE flows by introducing a ring-buffer-based CodeVerifierStorage that manages multiple flow slots, preventing verifier collisions during simultaneous OAuth or password-reset requests. Session management is now handled by a dedicated SessionManager actor that enforces commit guards to discard token refreshes that outlive their originating session, ensuring that concurrent sign-ins do not overwrite each other's state. The HTTP layer has been standardized to use HTTPTypes, and the API client now applies a retry policy that includes POST, PUT, and DELETE methods while explicitly excluding 429 status codes to avoid burning rate-limit quotas. Additionally, the module now supports local verification of ES256 JWTs and includes storage migrations to handle legacy session formats and key names. Also in this area: 11 commits (5 fixes) modifying Sources; Auth session isolation and PostgREST typed API signaling; Refactored Auth API layer and session persistence; Refined Auth error handling and Realtime reconnection logic; Auth session cleanup scoping and MFA challenge ID type change; and 1 more.

Sources/Auth/Internal · medium confidence · unverified

Functions client restructured with new error handling and invocation options

The Functions module has been rewritten to use a stateless \FunctionsClient\ struct and a new \FunctionsError\ type that exposes a \Kind\ enum (relay, http, transport, decoding) along with raw response data for debugging. Invocation is now controlled via \FunctionInvokeOptions\, which supports custom HTTP methods, query parameters, headers, and per-call timeout overrides, while the default request idle timeout is set to 150 seconds. The client also supports custom JSON decoders and access token injection, and re-exports the \Helpers\ module for internal use.

Sources/Functions · high confidence

HTTP layer refactored to use swift-http-types and a middleware-based transport

The HTTP helpers now use the \HTTPTypes\ standard library for request and response models, replacing the previous internal types. This introduces a unified \ClientTransport\ protocol and a \ClientMiddleware\ chain, allowing custom networking implementations and request/response transformations. Key additions include \AccessTokenMiddleware\ for automatic bearer token injection, a configurable \RetryPolicy\ with jittered exponential backoff, and streaming \HTTPBody\ support that improves upload performance and progress reporting.

Sources/Helpers/HTTP · high confidence

Introduce JSONValue as a unified JSON type representation

The library now provides a \JSONValue\ enum (alongside \JSONObject\ and \JSONArray\ typealiases) to represent JSON-compatible values, replacing the previous \AnyJSON\ type. This new type supports literal initializers for strings, integers, floats, booleans, arrays, and dictionaries, as well as \Codable\ conformance. It includes helper properties to extract underlying Swift values (e.g., \stringValue\, \intValue\) and extensions to decode into \Decodable\ types using configurable \JSONEncoder\ and \JSONDecoder\ instances. Also in this area: 11 commits (5 fixes) modifying Sources.

Sources/Helpers/JSONValue · medium confidence · unverified

Logging infrastructure replaced with swift-log

The internal logging implementation in the Helpers module has been migrated from the previous SupabaseLogger to the standard swift-log library. This change introduces a new default logger behavior: debug builds now automatically log at the warning level for visibility, while release builds use a zero-overhead no-op handler to eliminate performance costs. Additionally, an internal OSLogHandler is provided to support testing and parity with previous console output formats, and a new trace helper function is available for async operation logging. Also in this area: Fixes for Postgres timestamp parsing and date string encoding.

Sources/Helpers/Logger · high confidence

Replace Makefile with dedicated shell scripts for build, test, and CI tasks

The repository has removed the Makefile and replaced it with a suite of standalone shell scripts in the \scripts/\ directory to handle development and CI workflows. This includes \build-for-library-evolution.sh\ for building the library with evolution support, \check-compile-failures.sh\ to validate expected compile errors, \check-compliance.sh\ to verify public API declarations against \sdk-compliance.yaml\, and \check-for-breaking-api-changes.sh\ to detect API breakages. Testing and coverage are now managed by \test-android.sh\ (cross-compilation for Android), \test-integration.sh\ (integration suites with Docker/native stack support), \test-docs.sh\ (DocC warning checks), \generate-coverage.sh\ (coverage data merging and export), and \enable-storage-test-features.sh\ (enabling advanced Storage features for tests). Additional utilities include \format.sh\ for Swift formatting, \spell-check.sh\ for cspell integration, \refresh-typegen-fixtures.sh\ for updating PostgREST typegen fixtures, \load\_env.sh\ for environment variable loading, \run-on-linux.sh\ for Linux container execution, and \xcodebuild.sh\ for multi-platform Xcode builds. Also in this area: 6 commits (0 fixes) modifying scripts; 1 commit (0 fixes) modifying scripts; Improved CI script reliability for macOS symbol extraction and coverage accuracy.

scripts · medium confidence · unverified

Supabase client rewritten for v2 with unified configuration and OpenTelemetry support

The Supabase client has been completely rewritten for version 2, replacing the previous \Supabase.swift\ implementation with a new \SupabaseClient\ that uses a structured \SupabaseClientOptions\ configuration object. This change introduces a unified HTTP transport and middleware chain shared across all sub-clients (Auth, PostgREST, Storage, Realtime, Functions), allowing for consistent header injection (including a new \X-Client-Info\ header) and access token management. A key new capability is automatic W3C trace context propagation via OpenTelemetry, enabled by adding the \OpenTelemetry\ trait to the package dependency, which injects \traceparent\ headers into all outgoing requests. The rewrite also exposes explicit clock injection for deterministic testing of time-based behaviors like token refresh and retries, and consolidates sub-client options (database schema, storage hostname, function region) into the main client configuration.

Sources/Supabase · high confidence

Swift SDK v3 preparation: Swift 6.2 requirement, v3 migration guide, and configuration scaffolding

The repository is now prepared for the upcoming v3 release. The minimum supported toolchain has been raised to Swift 6.2 (Xcode 26.0+), and the supported platforms have been updated to iOS 16+, macOS 13+, tvOS 16+, watchOS 9+, and visionOS 1+. A comprehensive V3\_MIGRATION.md has been added to document breaking changes, including the removal of all previously deprecated APIs, the conversion of several public types from \Codable\ to \Decodable\ or \Encodable\-only, and the removal of the \emitLocalSessionAsInitialSession\ configuration option. Additionally, the project now includes configuration files for automated releases via release-please, linting via SwiftLint and swift-format, and spell-checking via cSpell. Also in this area: 8 commits (0 fixes) modifying (repo-wide); Edge Functions API overhaul: typed mutations, streaming, and cancellation fixes; Breaking changes to PostgREST API defaults and enum types.

(repo-wide) · low confidence · unverified

Test coverage

1 commit adding/updating tests in Tests/DocSnippetsTests; 11 commits adding/updating tests in Tests/SupabaseTypegenOutputTests; 150 commits adding/updating tests in Tests/RealtimeTests; 155 commits adding/updating tests in Tests/IntegrationTests; 26 commits adding/updating tests in Tests/DefaultIsolationTests; 34 commits adding/updating tests in Tests/PostgrestMacrosTests; 5 commits adding/updating tests in Tests/IntegrationTests/supabase/.temp; 54 commits adding/updating tests in Tests/HelpersTests; 7 commits adding/updating tests in Tests/AuthTests/WebAuthn; 76 commits adding/updating tests in Tests/StorageTests; 95 commits adding/updating tests in Tests/SupabaseTests; Added Supabase local development environment for integration tests; Added Swift Testing suite for Functions client invocation and error handling; Added comprehensive Swift Testing suite for PostgREST client; Added comprehensive test coverage for Auth module; Added integration test database schema and fixtures; Added mock session fixtures for Auth testing; Expanded PostgREST integration test coverage; Swift-format lint configuration and Linux test runner cleanup.

Dependencies

SDK v3 dependency overhaul and new OpenTelemetry example

The SDK has been upgraded to Swift 6.4 with stricter platform requirements (iOS 16, macOS 13, etc.) and a complete restructuring of its dependency graph. The legacy \gotrue-swift\ dependency was removed in favor of local modules (Auth, Functions, PostgREST, Realtime, Storage) and new dependencies including \swift-crypto\ (up to 5.0.0), \swift-http-types\, \swift-log\, and \swift-issue-reporting\. An OpenTelemetry demo example was added to showcase W3C trace context propagation, and a new \cspell\ tooling dependency was introduced for spell checking.

(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

Score

  • CAI 68 → 67 (-0.7)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 85 → 84 (-1.2)
  • Architecture 88 → 90 (+1.9)
  • Maturity 69 → 71 (+1.5)
  • Readiness 60 → 66 (+5.5)
  • Security 73 → 61 (-11.8)
  • Domain Modelling 81 (new)
  • Performance 85 → 100 (+15.0)

Resolved (136)

  • AuthClient.claims (cognitive 18) (Sources/Auth/AuthClient.swift)
  • Dependency not covered by the committed resolution: swift-issue-reporting
  • Duplicated block (10 lines × 4) (Examples/Examples/Auth/AuthWithMagicLink.swift)
  • Duplicated block (10 lines × 6) (Examples/Examples/Auth/AuthWithEmailAndPassword.swift)
  • Duplicated block (10–11 lines × 2) (Sources/Auth/AuthClient.swift)
  • Duplicated block (11 lines × 2) (Examples/Examples/Auth/AuthWithMagicLink.swift)
  • Duplicated block (11 lines × 2) (Sources/PostgREST/Untyped/PostgrestClient.swift)
  • Duplicated block (11 lines × 2) (Sources/PostgrestMacrosPlugin/SelectionOfMacro.swift)
  • Duplicated block (11 lines × 2) (Sources/Storage/ObjectListing.swift)
  • Duplicated block (11 lines × 6) (Examples/Examples/Storage/FileDownloadView.swift)
  • Duplicated block (12 lines × 2) (Examples/Examples/Profile/ProfileView.swift)
  • Duplicated block (12 lines × 2) (Sources/PostgREST/Untyped/PostgrestQueryBuilder.swift)
  • Duplicated block (12 lines × 3) (Examples/Examples/Auth/AuthWithMagicLink.swift)
  • Duplicated block (12 lines × 3) (Examples/Examples/Profile/UpdateProfileView.swift)
  • Duplicated block (12 lines × 3) (Sources/Auth/Types.swift)
  • Duplicated block (12 lines × 4) (Sources/Auth/Types.swift)
  • Duplicated block (13 lines × 2) (Examples/Examples/Auth/SignInWithPhone.swift)
  • Duplicated block (14 lines × 2) (Examples/Examples/Storage/FileDownloadView.swift)
  • Duplicated block (15 lines × 2) (Sources/Storage/Types.swift)
  • Duplicated block (16–20 lines × 3) (Examples/Examples/MFAFlow.swift)
  • …and 116 more

New (419)

  • CamelToSnake.swift.camelToSnakeCase (cognitive 16) (Sources/PostgrestMacrosPlugin/Support/CamelToSnake.swift)
  • Duplicated block (10 lines × 2) (Sources/Auth/Types.swift)
  • Duplicated block (10 lines × 2) (Sources/PostgREST/Query/PostgrestFunction.swift)
  • Duplicated block (11 lines × 3) (Sources/PostgrestMacrosPlugin/FunctionMacro.swift)
  • Duplicated block (11 lines × 6) (Examples/Examples/Storage/FileDownloadView.swift)
  • Duplicated block (12 lines × 2) (Examples/Examples/Realtime/BinaryBroadcastView.swift)
  • Duplicated block (12 lines × 2) (Sources/PostgREST/Untyped/PostgrestQueryBuilder.swift)
  • Duplicated block (13 lines × 2) (Sources/Functions/FunctionsError.swift)
  • Duplicated block (14 lines × 2) (Examples/Examples/Storage/FileDownloadView.swift)
  • Duplicated block (15 lines × 2) (Sources/Auth/CustomProvider.swift)
  • Duplicated block (15 lines × 2) (Sources/PostgREST/PostgrestError.swift)
  • Duplicated block (19 lines × 2) (Sources/PostgrestMacrosPlugin/FunctionMacro.swift)
  • Duplicated block (23 lines × 2) (Examples/Examples/Auth/ImportSessionView.swift)
  • Duplicated block (26 lines × 2) (Sources/PostgrestMacrosPlugin/Support/CamelToSnake.swift)
  • Duplicated block (5 lines × 2) (Sources/Functions/FunctionStreamResponse.swift)
  • Duplicated block (5 lines × 2) (Sources/PostgREST/Filters/PostgrestFilterValue.swift)
  • Duplicated block (6 lines × 2) (Examples/Reminders/App/Supabase/ListsRepository.swift)
  • Duplicated block (6 lines × 2) (Sources/Auth/WebAuthn/WebAuthnTypes.swift)
  • Duplicated block (6–7 lines × 2) (Sources/Auth/WebAuthn/WebAuthnOptions.swift)
  • Duplicated block (7 lines × 2) (Sources/Auth/Types.swift)
  • …and 399 more

Changes since last survey

  • 143 commits — 112 feature/other, 31 fixes

By area

  • Sources/Auth — 26 commits
  • Sources/Realtime — 18 commits
  • Tests/AuthTests — 16 commits
  • (root) — 12 commits
  • .github/workflows — 12 commits
  • Tests/RealtimeTests — 11 commits
  • Sources/Storage — 8 commits
  • tools/supabase-typegen — 5 commits
  • Sources/PostgREST — 4 commits
  • Tests/IntegrationTests — 4 commits
  • Examples/Examples — 3 commits
  • Sources/Helpers — 3 commits
  • Tests/DefaultIsolationTests — 3 commits
  • Tests/PostgRESTTests — 3 commits
  • Tests/StorageTests — 3 commits
  • Examples/Reminders — 2 commits
  • Tests/SupabaseTests — 2 commits
  • (repo) — 1 commit
  • .claude/skills — 1 commit
  • Sources/Functions — 1 commit

Notable commits

  • fix: chore(examples): rewrite the Realtime example views and fix the presence example (#1722)
  • fix: fix!: keep the default X-Client-Info out of configuration, and expose Auth retryEnabled on the facade (#1787)
  • fix: fix!: make isRetryable internal; the SDK owns retry decisions (#1784)
  • fix: fix!: middleware is the one way to send an access token, with one failure shape (#1779)
  • fix: fix!: shared error kinds, and wrap every client-side refusal as .invalidRequest (#1778)
  • fix: fix(auth)!: handle only redirects to a known callback, drop sb_flow_id, share the flow index per key (#1743)
  • fix: fix(auth): a failed linkIdentityURL request removes its PKCE flow (#1712)
  • fix: fix(auth): exchangeCodeForSession fails before the request when the PKCE verifier is missing (#1523)
  • fix: fix(auth): keep a newer stored session and guard user updates by user id (#1741)
  • fix: fix(auth): keep a newer stored session when a rejected refresh signs out (#1660)
  • fix: fix(auth): stop treating any message link as an email-change redirect (#1708)
  • fix: fix(helpers): HTTPClient owns cancellation mapping, the error-body cap, and the 429 rule (#1775)
  • fix: fix(helpers): keep LoggerInterceptor from failing a request when a body outgrows its declared length (#1796)
  • fix: fix(helpers): report an unknown length for an encoded response body (#1806)
  • fix: fix(postgrest): make @Table, @SelectionOf, and @Function expansions compile under default MainActor isolation (#1747)
  • fix: fix(postgrest): maybeSingle() no-row status and exact GET RPC arguments (#1789)
  • fix: fix(realtime)!: httpSend sends the configured headers, and Authorization only with a token (#1780)
  • fix: fix(realtime)!: rejoin a channel after a server phx_error (#1744)
  • fix: fix(realtime): don't rejoin a channel the caller unsubscribed across a reconnect (#1601)
  • fix: fix(realtime): let a subscribed channel join again after disconnect() (#1669)
  • …and 123 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-swift 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 15 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 ab192606ac346b2418bbda235858e9d8ec0a814c — the exact code this score is about.
  • Scored under rubric-2026.11.4 — 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.65+preprod-3c33c1882dc1.