Repository files navigation

Supabase SDK for Swift. Mirrors the design ofsupabase-js.

• Documentation:https://supabase.com/docs/reference/swift/introduction

• iOS 13.0+ / macOS 10.15+ / tvOS 13+ / watchOS 6+ / visionOS 1+
• Xcode 15.3+
• Swift 5.10+

Install the library using the Swift Package Manager.

letpackage=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") // Add as a dependency])])

If you're using Xcode,use this guide to addsupabase-swift to your project. Usehttps://github.com/supabase-community/supabase-swift.git for the url when Xcode asks.

If you don't want the full Supabase environment, you can also add individual packages, such asFunctions,Auth,Realtime,Storage, orPostgREST.

Then you're able to import the package and establish the connection with the database.

/// Create a single supabase client for interacting with your databaseletclient=SupabaseClient(    supabaseURL:URL(string:"https://xyzcompany.supabase.co")!,    supabaseKey:"public-anon-key")

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

Additional examples are availablehere.

This document outlines the scope of support for Xcode, Swift, and the various platforms (iOS, macOS, tvOS, watchOS, and visionOS) in Supabase.

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 Supabasewon'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 from Supabase in aminor release, andthis 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 aminor release, andthis 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.

• Fork the repo on GitHub
• Clone the project to your own machine
• Commit changes to your own branch
• Push your work back up to your fork
• Submit a Pull request so that we can review your changes and merge

We are building the features of Firebase using enterprise-grade, open source products. We support existing communities wherever possible, and if the products don’t exist we build them and open source them ourselves. Thanks to these sponsors who are making the OSS ecosystem better for everyone.