Tauri-Template

agent ready tauri template

Key Features • Quick Start • Configuration • Agent Skills • Credits • About the Core Contributors

---

Key Features

Modern stack for cross-platform desktop application development.

Feature	Tech Stack
Frontend	React + TypeScript + Vite
Backend	Native Rust (Tauri v2)
Engine	Shared Rust crate (no Tauri dep)
CLI Test Harness	appctl – headless engine runner
Config	Rust config crate (YAML + Env)
Logging	tracing + Redaction Layer
Package Manager	Bun
Formatting	Biome + cargo fmt

Quick Start

1. Initialize Project:

   make init name=my-app description="My cool app"

2. Install Dependencies:

   bun install

3. Run in Development:

   bun run tauri dev

4. Build:

   bun run tauri build

Asset Generation

• Use make logo / make banner to regenerate branding assets once per project. The targets run the Rust asset-gen CLI and require APP__GEMINI_API_KEY (set via .env).
• Logos/icons land under docs/public/, while the banner image is written to media/banner.png.

CLI Test Harness (appctl)

Headless CLI (crates/cli) that drives the same engine crate as the GUI — for VM-based compatibility testing without a window server. See crates/cli/README.md.

Configuration

Configuration is handled in Rust and exposed to the frontend via Tauri commands.

• Rust: Access via crate::global_config::get_config()
• Frontend: Access via useConfig() hook

Environment Variables

Prefix variables with APP__ to override YAML settings (e.g., APP__MODEL_NAME=gpt-4).

Agent Skills

Claude Code skills live in .claude/skills/. Invoke them with /skill-name.

Skill	Description
/update-backend	Guide for Rust backend changes — engine crate, Tauri commands, CLI harness, and testing patterns
/code-quality	Run formatting and linting checks (Biome + Clippy)
/prd	Generate a Product Requirements Document for a new feature
/ralph	Convert a PRD to prd.json format for the Ralph autonomous agent
/cleanup	Git branch hygiene — delete merged branches, prune stale refs, sync deps

Credits

This software uses the following tools:

• Tauri
• Bun
• Biome
• Rust

About the Core Contributors

Made with contrib.rocks.