Supabase Rust Client

A comprehensive, production-ready Rust client library for Supabase. This library provides a clean, type-safe, and efficient interface to interact with all Supabase services.

✨ Features

• 🔐 Authentication: Full auth support including MFA, OAuth, Phone Auth, Magic Links, Anonymous Sign-in, and Advanced Token Management
• 💾 Session Management: Cross-tab Sync, Platform Storage, Session Encryption, Session Events
• 🗄️ Database: Advanced Queries, Raw SQL, and Type-safe PostgREST operations
• 📁 Storage: File operations with Resumable Uploads, Advanced Metadata, Storage Policies, and Real-time Events
• 📡 Realtime: WebSocket subscriptions with Presence System, Broadcast Messages, Advanced Filters, and Connection Pooling
• ⚡ Cross-Platform: Full Native (Tokio) and WebAssembly (WASM) support
• 🛡️ Type Safety: Full Rust type system integration
• 🔧 Well Tested: 113 comprehensive tests (41 unit + 72 doc tests)

📦 Installation

Add this to your Cargo.toml:

[dependencies]
supabase-lib-rs = "0.5.3"
tokio = { version = "1.0", features = ["full"] }

Or use cargo to add it:

cargo add supabase-lib-rs

🏃 Quick Start

use supabase::prelude::*;

#[tokio::main]
async fn main() -> Result<()> {
    // Initialize the client
    let client = Client::new(
        "https://your-project.supabase.co",
        "your-anon-key"
    )?;

    // Authenticate user
    let auth_response = client
        .auth()
        .sign_in_with_email_and_password("user@example.com", "password")
        .await?;

    println!("User signed in: {:?}", auth_response.user);

    // Query database
    let posts = client
        .database()
        .from("posts")
        .select("id, title, content")
        .eq("status", "published")
        .order("created_at", Some(false))
        .limit(10)
        .execute()
        .await?;

    println!("Posts: {:?}", posts);

    Ok(())
}

📚 Documentation

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Quick Development Setup

# Clone the repository
git clone https://github.com/nizovtsevnv/supabase-lib-rs.git
cd supabase-lib-rs

# Setup development environment (requires Nix)
nix develop

# Run all checks
just check

📄 License

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

🔗 Links

• Supabase Documentation
• PostgREST API Reference
• Supabase Realtime
• Crates.io Package
• Documentation

🙏 Acknowledgments

• Supabase for providing an amazing backend platform
• The Rust community for excellent crates and tooling
• Contributors who help improve this library

Made with ❤️ for the Rust and Supabase communities