varandrew/moor / .agents/skills/tauri-v2
tauri-v2
VerifiedTauri v2+ cross-platform app development with Rust backend. Use when configuring tauri.conf.json, implementing Rust commands (#[tauri::command]), setting up IPC patterns (invoke, emit, channels), configuring permissions/capabilities, troubleshooting build issues, or deploying desktop/mobile apps. Triggers on Tauri, src-tauri, invoke, emit, capabilities.json.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 8.4 KB |
| SKILL.md | skill md | 17.4 KB |
| references/README.md | markdown | 2.2 KB |
| references/advanced-runtime-reference.md | markdown | 4.9 KB |
| references/capabilities-reference.md | markdown | 8.3 KB |
| references/ipc-patterns.md | markdown | 11.9 KB |
| references/plugin-reference.md | markdown | 8.7 KB |
| references/updater-distribution-reference.md | markdown | 4.2 KB |
README.md
View on GitHub# Tauri v2+ Development Skill
> Build cross-platform desktop and mobile apps with web frontends and Rust backends.
| | |
| --------------------- | --------------------- |
| **Status** | Active |
| **Version** | 1.0.1 |
| **Last Updated** | 2026-04-02 |
| **Confidence** | 4/5 |
| **Production Tested** | https://v2.tauri.app/ |
## What This Skill Does
Provides expert assistance for Tauri v2 application development, covering the full development lifecycle from project setup to cross-platform deployment. Specializes in Rust backend commands, IPC patterns, security configuration, and frontend-backend communication.
### Core Capabilities
- Implement Rust commands with `#[tauri::command]` and proper error handling
- Configure IPC patterns (invoke, events, channels) for frontend-backend communication
- Set up security capabilities and permissions for plugins and APIs
- Access exhaustive reference docs for plugins (fs, dialog, shell, store, etc.), updater/distribution signing, and advanced runtime (tray, sidecars, deep links)
- Build and deploy for desktop (macOS, Windows, Linux) and mobile (iOS, Android)
- Integrate Vite + TanStack Router frontends with Tauri backends
- Configure tauri.conf.json and Cargo.toml for cross-platform builds
## Auto-Trigger Keywords
### Primary Keywords
Exact terms that strongly trigger this skill:
- tauri
- tauri v2
- tauri.conf.json
- src-tauri
- #[tauri::command]
- tauri::invoke
- capabilities.json
### Secondary Keywords
Related terms that may trigger in combination:
- rust backend
- desktop app
- cross-platform app
- webview
- invoke command
- emit event
- app permissions
- bundle desktop
### Error-Based Keywords
Common error messages that should trigger this skill:
- "Command not found"
- "Permission denied" (in Tauri context)
- "Failed to invoke command"
- "Missing capability"
- "Cannot read property of undefined" (invoke result)
- "tauri build failed"
- "Missing Rust target"
## Known Issues Prevention
| Issue | Root Cause | Solution |
| ------------------ | ---------------------------------- | --------------------------------------------- |
| Command not found | Missing from `generate_handler![]` | Register all commands in the macro |
| Permission denied | Missing capability configuration | Add required permissions to capabilities file |
| State access panic | Type mismatch in `State<T>` | Use exact type matching `.manage()` call |
| White screen | Frontend not building | Verify `beforeDevCommand` and `devUrl` |
| Mobile build fails | Missing Rust targets | Run `rustup target add <platform-targets>` |
| IPC timeout | Blocking in async command | Use non-blocking async or spawn threads |
## When to Use
### Use This Skill For
- Creating new Tauri v2 projects or commands
- Configuring permissions and capabilities
- Setting up IPC (invoke, events, channels)
- Debugging command invocation issues
- Cross-platform build configuration
- Plugin integration and configuration
- Mobile (iOS/Android) deployment setup
### Don't Use This Skill For
- Tauri v1 development (use migration guide then this skill)
- Pure frontend development without Tauri integration
- Native mobile development (Swift/Kotlin directly)
- Backend API development without Tauri
## Version Policy
> [!NOTE]
> This skill targets **Tauri v2+**. Feature availability may vary across minor versions. When exact version timing matters, check the [official Tauri changelog](https://github.com/tauri-apps/tauri/blob/dev/crates/tauri/CHANGELOG.md) and release notes for `tauri`, `@tauri-apps/api`, `@tauri-apps/cli`, and relevant plugins.
## Quick Usage
```bash
# Create new Tauri project
npm create tauri-app@latest
# Add Tauri to existing project
npm install -D @tauri-apps/cli@latest
npx tauri init
# Development
npm run tauri dev
# Production build
npm run tauri build
# Add a plugin (e.g., fs, dialog, store)
cargo tauri add fs # Adds tauri-plugin-fs to Cargo.toml + JS package
cargo tauri add dialog
cargo tauri add store
# Mobile development
cargo tauri android init # One-time setup
cargo tauri android dev # Run on Android
cargo tauri android build # Release build
cargo tauri ios init # One-time setup (macOS only)
cargo tauri ios dev # Run on iOS simulator
cargo tauri ios build # Release build
```
## Token Efficiency
| Approach | Estimated Tokens | Time |
| --------------------- | ---------------- | -------------- |
| Manual Implementation | ~15,000 | 2+ hours |
| With This Skill | ~6,000 | 30 min |
| **Savings** | **60%** | **~1.5 hours** |
## Reference Documentation
For deep-dive guidance on specific topics, see the following reference files:
| Topic | Reference File | Purpose |
| -------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------- |
| **Security & Permissions** | [`capabilities-reference.md`](references/capabilities-reference.md) | V2 security model, capability files, permissions, and scopes |
| **IPC Patterns** | [`ipc-patterns.md`](references/ipc-patterns.md) | Decision framework for Commands, Events, and Channels |
| **Official Plugins** | [`plugin-reference.md`](references/plugin-reference.md) | Install, registration, and permissions for all official plugins |
| **Updater & Distribution** | [`updater-distribution-reference.md`](references/updater-distribution-reference.md) | Signing, updater setup, and platform-specific distribution |
| **Advanced Runtime** | [`advanced-runtime-reference.md`](references/advanced-runtime-reference.md) | Tray icons, sidecars, deep links, and custom protocols |
See the [References Index](references/README.md) for a complete navigation guide.
## File Structure
```
tauri-v2/
├── SKILL.md # Quick-start patterns, core rules, critical guidance
├── README.md # This file - discovery and quick reference
└── references/ # Deep-dive reference documentation
├── README.md # Index and navigation
├── capabilities-reference.md # Security model, permissions, scopes
├── ipc-patterns.md # Commands, events, channels decision framework
├── plugin-reference.md # Exhaustive plugin install/register/permissions
├── updater-distribution-reference.md # Signing, HTTPS, platform distribution
└── advanced-runtime-reference.md # Tray, sidecars, deep links, protocols
```
## Dependencies
| Package | Version | Verified |
| -------------------- | -------- | ------------ |
| `@tauri-apps/cli` | ^2 (v2+) | 2026-04-02\* |
| `@tauri-apps/api` | ^2 (v2+) | 2026-04-02\* |
| `tauri` (Rust) | ^2 (v2+) | 2026-04-02\* |
| `tauri-build` (Rust) | ^2 (v2+) | 2026-04-02\* |
_\*Last verified: 2026-04-02. Always check [official changelog](https://github.com/tauri-apps/tauri/blob/dev/crates/tauri/CHANGELOG.md) for feature timing._
## Official Documentation
- [Tauri v2+ Documentation](https://v2.tauri.app/)
- [Commands Reference](https://v2.tauri.app/develop/calling-rust/)
- [IPC Concepts](https://v2.tauri.app/concept/inter-process-communication/)
- [Capabilities & Permissions](https://v2.tauri.app/security/capabilities/)
- [Configuration Reference](https://v2.tauri.app/reference/config/)
- [Plugin Directory](https://v2.tauri.app/plugin/)
## Related Skills
- `tanstack-start-expert` - TanStack Router patterns for type-safe frontend routing
- `react-component-architect` - React component patterns for Tauri frontends
- `go-google-style-expert` - Alternative backend patterns (if using Go instead)
## Companion Agent (Deprecated)
The `tauri-v2-expert` agent at `.claude/agents/specialized/tauri/tauri-v2-expert.md` is **deprecated/legacy**. This skill is the preferred and actively maintained interface. Use this skill over the agent for all new Tauri v2 work.
---
**License:** MIT
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |