The official Rust client for Convex.

Convex is the backend application platform with everything you need to build your product.

This Rust client can write and read data from a Convex backend with queries, mutations, and actions. Get up and running at docs.convex.dev.

Join us on Discord to share what you're working on or get your questions answered.

Add the following to your Cargo.toml file

[dependencies]
convex = "*"

let mut client = ConvexClient::new(DEPLOYMENT_URL).await?;
let mut subscription = client.subscribe("getCounter", vec![]).await?;
while let Some(new_val) = subscription.next().await {
    println!("Counter updated to {new_val:?}");
}

Check out the full convex documentation at docs.convex.dev The rust API docs are available on docs.rs

The Convex rust client works on stable rust 1.65.0 and higher. It also works on nightly.

The Convex Rust Client uses the tracing crate for logging. One common way of initializing is via tracing_subscriber. Then, you can see debug logging by running your program with RUST_LOG=convex=debug.

tracing_subscriber::fmt()
    .with_env_filter(tracing_subscriber::EnvFilter::from_default_env())
    .init();