tauri-expert

Provides Tauri 2 configuration, capabilities, sidecar, packaging, and CI guidance for desktop applications.

Updated Jun 24, 2026
One-click install
npx skills add https://github.com/psmfd/pi-config --skill tauri-expert-psmfd
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tauri-expert
Source: https://github.com/psmfd/pi-config/tree/main/agent/skills/tauri-expert
Command: npx skills add https://github.com/psmfd/pi-config --skill tauri-expert-psmfd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Tauri 2 projects fail in non-obvious ways: cargo clippy panics on missing icons, capability files silently stop auto-loading, sidecar binaries are rejected for naming mistakes, and CI matrices break on Linux dependency or caching misconfiguration. This Skill gives a subagent authoritative, version-aware answers on Tauri 2 configuration, security capabilities, packaging, sidecars, plugins, and CI without trial-and-error. ## Core Features & Use Cases - Configuration reference: Explains tauri.conf.json schema keys, v1-to-v2 renames, and the critical build-phase vs bundle-phase distinction behind proc-macro failures. - Capabilities and security: Details the v2 capability file format, permission identifier syntax, core:default composition, and scoped filesystem permissions. - Sidecars and packaging: Covers bundle.externalBin naming with Rust target triples, .NET RID mapping, bundle types per platform, and the icon pipeline. - CI and signing: Provides a GitHub Actions 3-OS matrix, Linux system dependency tables, cross-compilation guidance, and code-signing environment variables. - Use Case: A developer's cargo clippy fails with a proc-macro panic about a missing icon; the Skill identifies the generate_context!() compile-time icon requirement and prescribes generating or committing placeholder icons. ## Quick Start Ask the tauri-expert agent why your Tauri 2 build or bundle step is failing, or how to configure a specific tauri.conf.json key, capability, sidecar, or CI job.

Frequently Asked Questions about tauri-expert

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why does cargo clippy fail with a missing icon error in Tauri 2?▼

The `generate_context!()` proc macro reads icons at compile time, so `cargo clippy` panics when `icons/icon.png` or `icons/icon.ico` is missing. Run `cargo tauri icon <source.png>` or commit placeholder icons before clippy runs.

How do I configure capabilities in Tauri 2?▼

Place JSON capability files in `src-tauri/capabilities/` declaring windows, platforms, and permissions like `core:default`. Listing any capability in `app.security.capabilities` disables auto-load, so you must then list every capability explicitly.

How do I add a sidecar binary to a Tauri app?▼

Declare the path prefix in `bundle.externalBin`, name the binary with the host Rust target triple (plus `.exe` on Windows), and grant `shell:allow-execute` with `sidecar: true` in a capability file. Invoke it via the shell plugin's `sidecar()` API.

Does Tauri 2 support the v1 allowlist configuration?▼

No, Tauri 2 replaces the v1 allowlist with capability files, and v1 is end-of-life. Run `cargo tauri migrate` on the unmodified v1 project to convert the allowlist and rename configuration keys automatically.

What Linux dependencies does Tauri 2 need in CI?▼

Tauri 2 requires `libwebkit2gtk-4.1-dev` (not 4.0), `libayatana-appindicator3-dev`, `librsvg2-dev`, `patchelf`, and `libxdo-dev`. Linux CI also needs a display server such as Xvfb for `tauri build`.

What are the limitations of the tauri-expert skill?▼

It is read-only and never modifies files, covers desktop only (no iOS/Android), and excludes custom Rust plugin authoring. Tauri 1 patterns are out of scope beyond recommending `cargo tauri migrate`.