tauri

---
name: tauri
description: >-
license: Apache-2.0
---

# Tauri

## Overview

Tauri is a framework for building cross-platform desktop and mobile applications using any web framework for the frontend and Rust for the backend. By using the system webview instead of bundling Chromium, Tauri produces binaries under 10MB with 30-80MB memory usage, featuring capability-based security, type-safe IPC commands, and a plugin ecosystem for native APIs.

## Instructions

- When setting up the architecture, build the UI with any web framework (React, Vue, Svelte, Solid) rendered in the system webview, and implement system access and heavy computation in Rust backend commands.
- When implementing IPC, define Rust functions with `#[tauri::command]` for request-response patterns (called via `invoke()` from JS), and use events for push-style communication from backend to frontend.
- When accessing native APIs, use Tauri plugins (`@tauri-apps/plugin-fs`, `@tauri-apps/plugin-dialog`, `@tauri-apps/plugin-shell`, `@tauri-apps/plugin-notification`) and define allowed capabilities in the `capabilities/` directory.
- When managing security, define capability-based permissions to restrict which APIs the frontend can access, set CSP headers, and use the isolation pattern for sandboxed environments.
- When building for distribution, use `cargo tauri build` to produce platform-specific installers (NSIS/MSI for Windows, DMG for macOS, AppImage/deb for Linux) with code signing and notarization.
- When implementing auto-updates, use `@tauri-apps/plugin-updater` with GitHub Releases or a custom server, with signature verification to prevent tampering.

## Examples

### Example 1: Build a note-taking app with encrypted local storage

**User request:** "Create a Tauri note-taking app with local file storage and encryption"

**Actions:**
1. Set up a Svelte frontend with the Tauri project scaffolding
2. Implement Rust commands for reading, writing, and encrypting note files using the `aes-gcm` crate
3. Use `@tauri-apps/plugin-store` for app settings and `@tauri-apps/plugin-dialog` for file dialogs
4. Configure capability permissions to allow only the required file system paths

**Output:** A lightweight note-taking app with encrypted local storage and native file dialogs, under 10MB.

### Example 2: Build a system monitoring dashboard

**User request:** "Create a desktop app that shows CPU, memory, and disk usage in real time"

**Actions:**
1. Define Rust commands using the `sysinfo` crate to collect system metrics
2. Use Tauri events to push metric updates from backend to frontend every second
3. Build a React dashboard with real-time charts displaying CPU, memory, and disk usage
4. Add system tray icon with quick-view menu using `@tauri-apps/plugin-tray`

**Output:** A real-time system monitor with tray icon, using under 50MB of memory.

## Guidelines

- Use commands for request-response patterns and events for push notifications; do not mix them.
- Define all allowed APIs in `capabilities/` following the principle of least privilege.
- Use `tauri::State<Mutex<T>>` for shared mutable state since Rust enforces thread safety.
- Use `@tauri-apps/plugin-store` over `localStorage` for persistent data since it survives app updates.
- Handle errors in Rust with `Result<T, String>` so error messages surface as rejected promises in JS.
- Keep the frontend framework-agnostic since Tauri works with any web framework.
- Use the auto-updater with signature verification for production apps.