Guides · Reference Docs

• iOS 16.0+ / macOS 13.0+ / tvOS 16+ / watchOS 9+ / visionOS 1+
• Xcode 26.0+
• Swift 6.2+

Add supabase-swift as a Swift Package Manager dependency:

let package = Package(
    ...
    dependencies: [
        .package(
            url: "https://github.com/supabase/supabase-swift.git",
            from: "2.0.0"
        ),
    ],
    targets: [
        .target(
            name: "YourTargetName",
            dependencies: [
                .product(name: "Supabase", package: "supabase-swift")
            ]
        )
    ]
)

If you're using Xcode, use this guide to add supabase-swift to your project. Use https://github.com/supabase/supabase-swift.git for the URL when Xcode asks.

You can also add individual libraries (Auth, Realtime, Storage, PostgREST, Functions) instead of the full Supabase product.

let client = SupabaseClient(
    supabaseURL: URL(string: "https://xyzcompany.supabase.co")!,
    supabaseKey: "your-publishable-key"
)

let client = SupabaseClient(
    supabaseURL: URL(string: "https://xyzcompany.supabase.co")!,
    supabaseKey: "your-publishable-key",
    options: SupabaseClientOptions(
        db: .init(
            schema: "public"
        ),
        auth: .init(
            storage: MyCustomLocalStorage(),
            flowType: .pkce
        ),
        global: .init(
            headers: ["x-my-custom-header": "my-app-name"],
            http: .init(transport: URLSessionTransport(session: URLSession.myCustomSession))
        )
    )
)

struct Answer: Decodable { let text: String }

// JSON in, typed JSON out
let answer: Answer = try await client.functions.invoke("ask", body: .json(["prompt": "hi"]))

// Raw response: status, headers, bytes
let response = try await client.functions.invoke("report", options: .init(method: .get))
print(response.status, response.body.count)

let response = try await client.functions.stream("chat", body: .json(["prompt": "hi"]))
for try await chunk in response.body {
  // chunk boundaries follow the network; frame server-sent events yourself
}

Additional examples are available in the Examples directory.

We only support Xcode versions that are currently eligible for submitting apps to the App Store. Once a specific version of Xcode is no longer supported, its removal from Supabase won't be treated as a breaking change and will occur in a minor release.

The minimum supported Swift version corresponds to the minor version released with the oldest-supported Xcode version. When a Swift version reaches its end of support, it will be dropped in a minor release, and this won't be considered a breaking change.

We maintain support for the four latest major versions of each platform, including the current version.

When a platform version is no longer supported, Supabase will drop it in a minor release, and this won't count as a breaking change. For instance, iOS 14 will no longer be supported after the release of iOS 18, allowing its removal in a minor update.

For macOS, the named yearly releases are treated as major versions for this policy, regardless of their version numbers.

We welcome contributions! Please see the steps below.

1. Fork the repo and clone it locally.
2. Create a feature branch (git checkout -b feature/my-feature).
3. Make your changes and add tests.
4. Run ./scripts/format.sh to format Swift code.
5. Run PLATFORM=IOS XCODEBUILD_ARGUMENT=test ./scripts/xcodebuild.sh to verify tests pass.
6. Commit using Conventional Commits (e.g. feat(auth): add PKCE support).
7. Open a pull request against main.

• Documentation: supabase.com/docs/reference/swift
• Community: GitHub Discussions
• Issues: GitHub Issues
• Discord: Supabase Discord

This project is licensed under the MIT License — see the LICENSE file for details.