Tauri

Build desktop apps with a web frontend and Rust backend - lightweight shells, typed IPC, and OS integration.

Recipe

#[tauri::command]
fn read_text(path: String) -> Result<String, String> {
    std::fs::read_to_string(path).map_err(|e| e.to_string())
}
 
fn main() {
    tauri::Builder::default()
        .invoke_handler(tauri::generate_handler![read_text])
        .run(tauri::generate_context!())
        .expect("error running tauri");
}

When to reach for this:

• Teams strong in React/Svelte/Vue wanting native packaging
• Apps needing filesystem, clipboard, or shell access from Rust
• Smaller download size vs Electron
• Security-sensitive operations kept out of JavaScript

Working Example

use serde::Serialize;
use tauri::State;
use std::sync::Mutex;
 
#[derive(Default)]
struct AppState {
    counter: Mutex<i32>,
}
 
#[derive(Serialize)]
struct CounterResponse {
    value: i32,
}
 
#[tauri::command]
fn increment(state: State<AppState>) -> CounterResponse {
    let mut c = state.counter.lock().unwrap();
    *c += 1;
    CounterResponse { value: *c }
}
 
fn main() {
    tauri::Builder::default()
        .manage(AppState::default())
        .invoke_handler(tauri::generate_handler![increment])
        .run(tauri::generate_context!())
        .expect("tauri run failed");
}

What this demonstrates:

• Managed state across command invocations
• Serde JSON responses to frontend
• Minimal command registration in builder

Deep Dive

How It Works

• WebView renders UI assets from dist/ folder.
• IPC serializes command args/responses with serde.
• Rust plugins add deep links, updater, and shell scopes.
• Capabilities (Tauri 2) replace blanket allow lists.

Tauri vs Electron

Gotchas

• Exposing raw paths from JS - path traversal if unchecked. Fix: canonicalize and verify under app dir.
• Blocking in sync commands - freezes UI WebView. Fix: async commands for IO-heavy work.
• Missing CSP - XSS in UI becomes RCE via IPC. Fix: strict Content-Security-Policy in config.
• Dev-only unwrap in commands - panics kill app. Fix: return Result to frontend.
• Platform WebView differences - test Safari WebView on macOS and WebView2 on Windows separately.

Alternatives

FAQs

Related

• GUI Basics - landscape
• State & Architecture - shared state
• Packaging & Distribution - installers
• Native Integration - OS APIs

Stack versions: This page was written for Rust 1.97.0 (edition 2024), Tokio 1.x, Axum 0.8, serde 1.0, sqlx 0.8, clap 4, and Polars 0.46+. 636f64656775696465732e696f7c6367696f3136387c323032363037