Tauri Knowledge Patch

Covers Tauri 2.0–2.5 (Oct 2024 – Apr 2025). Claude knows Tauri v1.x (Rust backend + web frontend, tauri::command, v1 allowlist, tauri.conf.json v1). It is unaware of the v2 architecture and any of the changes below.

Index

Topic	Reference	Key features
Config v2	references/config-v2.md	tauri key renamed to app, top-level productName/identifier, frontendDist/devUrl
Permissions & Capabilities	references/permissions-capabilities.md	Replaces allowlist, capability files, platform-specific, remote URL access
IPC: Channels & Response	references/ipc.md	Channel<T> streaming, ipc::Response for binary data
Mobile support	references/mobile.md	mobile_entry_point, lib.rs/main.rs split, crate-type config
Plugin system v2	references/plugin-system.md	Built-in APIs moved to plugins, cargo tauri add, JS import changes
Event system	references/events.md	Emitter/Listener traits, emit_to, listen_any, emit_str*
API additions	references/api-additions.md	Window colors, badging, reload, cookies, restart, dock visibility

---

Config v2 Quick Reference

tauri.conf.json restructured. Key renames:

v1 Key	v2 Key
tauri	app
package.productName	productName (top-level)
build.distDir	build.frontendDist
build.devPath	build.devUrl
tauri.allowlist	removed (use capabilities)
tauri.systemTray	app.trayIcon
tauri.bundle	bundle (top-level)
cli/updater config	plugins.cli / plugins.updater

Must add identifier (reverse-domain) and mainBinaryName at top level.

{
  "productName": "my-app",
  "version": "0.1.0",
  "identifier": "com.example.myapp",
  "mainBinaryName": "my-app",
  "build": {
    "frontendDist": "../dist",
    "devUrl": "http://localhost:5173"
  },
  "app": {
    "security": {
      "capabilities": [
        "main-capability"
      ]
    },
    "windows": [
      {
        "title": "My App",
        "width": 800,
        "height": 600
      }
    ]
  },
  "bundle": {},
  "plugins": {}
}

---

Capabilities (replaces v1 allowlist)

Place JSON/TOML files in src-tauri/capabilities/ (auto-enabled). Each capability grants permissions to specific windows:

{
  "$schema": "../gen/schemas/desktop-schema.json",
  "identifier": "main-capability",
  "windows": ["main"],
  "permissions": [
    "core:path:default",
    "core:event:default",
    "core:window:default",
    "core:app:default",
    "fs:read-files",
    "fs:scope-home"
  ]
}

Platform-specific: add "platforms": ["linux", "macOS", "windows"] or ["iOS", "android"]. Remote access: use "remote": { "urls": ["https://*.example.com"] } instead of "windows".

Custom permission sets in src-tauri/permissions/<name>.toml:

[[set]]
identifier = "allow-home-read"
description = "Read access to home directory"
permissions = ["fs:read-files", "fs:scope-home"]

---

IPC Channels

tauri::ipc::Channel<T> for ordered Rust-to-frontend streaming (replaces events for progress/streaming):

use serde::Serialize;
use tauri::ipc::Channel;

#[derive(Clone, Serialize)]
#[serde(rename_all = "camelCase", tag = "event", content = "data")]
enum DownloadEvent {
    Started { url: String, content_length: usize },
    Progress { chunk_length: usize },
    Finished,
}

#[tauri::command]
fn download(url: String, on_event: Channel<DownloadEvent>) {
    on_event
        .send(DownloadEvent::Started {
            url,
            content_length: 1000,
        })
        .unwrap();
    on_event.send(DownloadEvent::Finished).unwrap();
}

import { invoke, Channel } from '@tauri-apps/api/core';

const onEvent = new Channel<DownloadEvent>();
onEvent.onmessage = (msg) => console.log(msg.event, msg.data);
await invoke('download', { url: 'https://example.com', onEvent });

Binary returns without JSON overhead: fn read_file(path: String) -> tauri::ipc::Response { Response::new(std::fs::read(path).unwrap()) }

---

Mobile Entry Point

// src-tauri/src/lib.rs (shared)
#[cfg_attr(mobile, tauri::mobile_entry_point)]
pub fn run() {
    tauri::Builder::default()
        .invoke_handler(tauri::generate_handler![/* commands */])
        .run(tauri::generate_context!())
        .expect("error while running tauri application");
}

Desktop-only main.rs calls app_lib::run(). Add crate-type = ["staticlib", "cdylib", "rlib"] to Cargo.toml [lib].

---

Plugin System v2

Built-in v1 APIs moved to plugins. Install: cargo tauri add <plugin>. Register: .plugin(tauri_plugin_fs::init()).

v1 API	v2 Plugin	JS Package
tauri.allowlist.fs	tauri-plugin-fs	@tauri-apps/plugin-fs
tauri.allowlist.http	tauri-plugin-http	@tauri-apps/plugin-http
tauri.allowlist.dialog	tauri-plugin-dialog	@tauri-apps/plugin-dialog
tauri.allowlist.shell	tauri-plugin-shell	@tauri-apps/plugin-shell
tauri.updater	tauri-plugin-updater	@tauri-apps/plugin-updater
@tauri-apps/api/clipboard	tauri-plugin-clipboard-manager	@tauri-apps/plugin-clipboard-manager
@tauri-apps/api/notification	tauri-plugin-notification	@tauri-apps/plugin-notification
@tauri-apps/api/os	tauri-plugin-os	@tauri-apps/plugin-os
@tauri-apps/api/process	tauri-plugin-process	@tauri-apps/plugin-process

JS imports: @tauri-apps/api/tauri -> @tauri-apps/api/core. @tauri-apps/api/window -> @tauri-apps/api/webviewWindow.

---

Event System

Emitter and Listener are now traits — use tauri::{Emitter, Listener}. emit sends to all. emit_to targets a webview. emit_filter filters by EventTarget. listen_global renamed to listen_any.

---

Notable API Additions (v2.1–v2.5)

API	Version
Window::set_background_color / WindowBuilder::background_color	v2.1
app > security > headers config for response headers	v2.1
useHttpsScheme config option (Windows/Android)	v2.1
WebviewBuilder::devtools (per-webview)	v2.1
set_badge_count, set_overlay_icon, set_badge_label	v2.2
WebviewBuilder::data_store_identifier (macOS)	v2.2
WebviewBuilder::extensions_path (Linux/Windows)	v2.2
emit_str* methods (pre-serialized JSON)	v2.3
App::run_return (returns exit code)	v2.4
AppHandle::request_restart()	v2.4
Webview::reload / WebviewWindow::reload	v2.4
Webview::cookies() / cookies_for_url()	v2.4
build > removeUnusedCommands config	v2.4
WebviewBuilder::disable_javascript	v2.4
trafficLightPosition window config (macOS)	v2.4
set_dock_visibility (macOS)	v2.5
initialization_script_on_all_frames (iframe)	v2.5
preventOverflow config (clamp to monitor)	v2.5
WebviewBuilder::allow_link_preview (macOS/iOS)	v2.5