supabase-client-sdk

Rust client for Supabase with fluent API — REST by default, direct SQL opt-in.

Installation

[dependencies]
supabase-client-sdk = "0.2.1"
# Or with specific features:
supabase-client-sdk = { version = "0.2.1", features = ["auth", "realtime"] }

Feature Flags

Feature	Default	Description
`query`	Yes	Query builder (select, insert, update, delete, upsert, rpc)
`derive`	Yes	`#[derive(Table)]` proc macro
`auth`	No	GoTrue authentication client
`realtime`	No	WebSocket realtime subscriptions
`storage`	No	Object storage client
`functions`	No	Edge Functions client
`direct-sql`	No	Direct PostgreSQL via sqlx (bypasses PostgREST)
`full`	No	All features enabled

Quick Start

use supabase_client_sdk::prelude::*;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let config = SupabaseConfig::new(
        "https://your-project.supabase.co",
        "your-anon-key",
    );

    let client = SupabaseClient::new(config)?;

    let response = client.from("cities")
        .select("*")
        .execute()
        .await;

    for row in response.into_result()? {
        println!("{}", row.get_as::<String>("name").unwrap());
    }

    Ok(())
}

Architecture

This is the facade crate that re-exports all sub-crates behind feature flags:

Crate	Description
`supabase-client-core`	`SupabaseClient`, config, errors, response types
`supabase-client-query`	Query builder, filters, modifiers, RPC
`supabase-client-derive`	`#[derive(Table)]` proc macro
`supabase-client-auth`	GoTrue authentication client
`supabase-client-realtime`	WebSocket realtime client
`supabase-client-storage`	Object storage client
`supabase-client-functions`	Edge Functions client
`supabase-client-wasm`	WASM/TypeScript bindings

Each sub-crate provides an extension trait on SupabaseClient:

SupabaseClientQueryExt — .from(), .from_typed(), .rpc()
SupabaseClientAuthExt — .auth()
SupabaseClientRealtimeExt — .realtime()
SupabaseClientStorageExt — .storage()
SupabaseClientFunctionsExt — .functions()

See the repository README for full documentation, examples, and usage guides.

License