supabase/supabase-swift
67.4
Adequate · 15 November 2026
57.3k
lines of production code
Swift
primary language
5
measurements over time
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.