Waterkit

Waterkit is a comprehensive, modular collection of cross-platform utilities designed to empower Rust applications with native system capabilities. It bridges the gap between Rust and platform-specific APIs (iOS, Android, macOS, Windows, Linux), allowing you to build rich, native-feeling applications with a unified Rust interface.

Modules

Waterkit is organized into focused, independent crates. You can use the main waterkit crate with feature flags, or depend on individual crates directly.

Advanced Modern Capabilities

• Hardware-accelerated media pipelines (codec, video) with platform-native backends and GPU-friendly paths.
• Privacy-first device access flows (permission, biometric, secret) for secure user consent and authentication.
• Deep OS integrations (bluetooth, nfc, health, contacts, calendar, notification, deeplink, share, speech).
• Async-first APIs across modules to fit modern concurrent Rust application architecture.
• full feature as a complete capability bundle, continuously validated by automated feature-surface tests.

📦 Installation

Add waterkit to your Cargo.toml. We recommend enabling only the features you need to keep compile times low.

[dependencies]
waterkit = { version = "0.1", features = ["location", "dialog", "haptic"] }

Full Installation

If you want everything:

[dependencies]
waterkit = { version = "0.1", features = ["full"] }

Platform Support

Waterkit uses a mix of pure Rust crates and native bridges (Swift/Kotlin) to achieve maximum compatibility and performance.

Usage Example

Here's a quick example of using multiple modules together:

use waterkit::dialog::Dialog;
use waterkit::location::Location;
use waterkit::permission::{Permission, PermissionStatus};

async fn example() -> Result<(), Box<dyn std::error::Error>> {
    // 1. Check Permissions
    let perm = waterkit::permission::check(Permission::Location).await;

    // 2. Request if needed
    let status = if perm == PermissionStatus::Granted {
        perm
    } else {
        waterkit::permission::request(Permission::Location).await?
    };

    if status != PermissionStatus::Granted {
        // 3. Show Native Alert
        Dialog::new(
            "Permission Denied",
            "We need location access to show you the map.",
        )
        .show()
        .await?;
        return Ok(());
    }

    // 4. Use Location
    let loc = Location::get().await?;
    log::info!(
        "Location: {}, {}",
        loc.latitude().get(),
        loc.longitude().get()
    );
    Ok(())
}

Contributing

Contributions are welcome! Please check individual crate directories for specific implementation details.

License

MIT OR Apache-2.0 License