AndroidPoet

I Built a Leaner Supabase SDK for Kotlin Multiplatform. Here’s Why It’s Architecturally Better

Android Poet

5 min read

How trading framework-heavy SDK design for explicit results, typed IDs, direct composition, and Kotlin-first APIs made Supabase feel cleaner in Kotlin Multiplatform.

When I first started building Kotlin Multiplatform apps with Supabase, I reached for the official Kotlin SDK.

AndroidPoet

result
    .onSuccess { cities -> println(cities) }
    .onFailure { error -> println(error.message) }

AndroidPoet

val result = database.selectTyped<City>(
    table = "cities",
) {
    eq("name", "Paris")
}

AndroidPoet

val data = supabase.postgrest["cities"]
    .select {
        City::name eq "Paris"
    }
    .decodeList<City>()

AndroidPoet

@Serializable
data class Todo(
    val id: String,
    val title: String,
    val done: Boolean,
)

val todos = database.selectTyped<Todo>(
    table = "todos",
) {

AndroidPoet

val auth = createAuthClient(client)
val database = createDatabaseClient(client)
val storage = createStorageClient(client)
val realtime = createRealtimeClient(client)
val functions = createFunctionsClient(client)

AndroidPoet

val client = Supabase.create(
    projectUrl = "https://your-project.supabase.co",
    apiKey = "your-anon-key",
) {
    logging = true
}

AndroidPoet

[versions]
supabase-kmp = "0.3.2"

[libraries]
supabase-core = { module = "io.github.androidpoet:supabase-core", version.ref = "supabase-kmp" }
supabase-client = { module = "io.github.androidpoet:supabase-client", version.ref = "supabase-kmp" }
supabase-auth = { module = "io.github.androidpoet:supabase-auth", version.ref = "supabase-kmp" }
supabase-auth-admin = { module = "io.github.androidpoet:supabase-auth-admin", version.ref = "supabase-kmp" }
supabase-database = { module = "io.github.androidpoet:supabase-database", version.ref = "supabase-kmp" }
supabase-storage = { module = "io.github.androidpoet:supabase-storage", version.ref = "supabase-kmp" }

AndroidPoet

val bucketId = BucketId("avatars")

getUser(bucketId) // Compile error if getUser expects UserId

AndroidPoet

@JvmInline
value class UserId(val value: String)

@JvmInline
value class BucketId(val value: String)

@JvmInline
value class ChannelId(val value: String)