Tauri App Template

English | 简体中文

A modern desktop application template built with Tauri v2 + React 19 + TypeScript + shadcn/ui.

Preview

Features

• ✨ Modern Tech Stack - Tauri v2 + React 19 + TypeScript + Vite
• 🎨 Beautiful UI Components - Integrated shadcn/ui component library and Tailwind CSS v4
• 🌓 Dark Mode Support - Built-in light/dark theme toggle
• 🌍 Internationalization - i18next integration with English and Chinese support
• 🖼️ Custom Titlebar - Frameless transparent window with drag, minimize, maximize, and close support
• 🗂️ Multi-Window Management - Support for child windows, window lifecycle management, and delayed destruction
• 🔔 System Tray Integration - Tray icon, menu, and window show/hide support
• 📦 Ready to Use - Pre-configured with Prettier and TypeScript strict mode
• 🚀 Fast Development - Vite HMR + Tauri hot reload

Tech Stack

• Desktop Framework: Tauri v2
• Frontend Framework: React 19 + TypeScript
• Build Tool: Vite
• UI Components: shadcn/ui
• Styling: Tailwind CSS v4
• Code Formatting: Prettier

Getting Started

Prerequisites

• Node.js >= 18
• pnpm >= 9
• Rust >= 1.70

Install Dependencies

pnpm install

Development Mode

pnpm tauri dev

Build for Production

pnpm tauri build

Adding shadcn/ui Components

pnpm dlx shadcn@latest add <component-name>

Examples:

pnpm dlx shadcn@latest add button
pnpm dlx shadcn@latest add input
pnpm dlx shadcn@latest add dialog

Code Formatting

pnpm format        # Format code
pnpm format:check  # Check code formatting

Project Structure

.
├── src/                    # Frontend source code
│   ├── components/         # React components
│   │   └── ui/            # shadcn/ui components
│   ├── i18n/              # Internationalization
│   │   ├── index.ts       # i18n configuration
│   │   └── locales/       # Translation files
│   ├── lib/               # Utility functions
│   ├── App.tsx            # Main app component
│   └── main.tsx           # Entry point
├── src-tauri/             # Tauri/Rust backend
│   ├── src/               # Rust source code
│   └── tauri.conf.json    # Tauri configuration
├── docs/                  # Documentation
│   ├── AUTO_UPDATE.md     # Auto update guide
│   └── I18N.md            # Internationalization guide
├── components.json        # shadcn/ui configuration
└── package.json

CI/CD

This project uses GitHub Actions for automated builds and releases.

Automated Release

The workflow is triggered by pushing tags matching v* (e.g., v0.1.0).

Create and push a tag:

git tag v0.1.0
git push origin v0.1.0

Build Outputs

The workflow generates:

• NSIS Installer - Windows installation package
• Updater Files - latest.json for auto-update support

Auto Update Setup

To enable automatic updates, you need to:

1. Generate signing keys: pnpm tauri signer generate -w ~/.tauri/myapp.key
2. Add GitHub secrets: TAURI_SIGNING_PRIVATE_KEY and TAURI_SIGNING_PRIVATE_KEY_PASSWORD

Note: The public key and update endpoints in tauri.conf.json are automatically configured by GitHub Actions during the build process. No manual configuration is required.

See Auto Update Configuration for detailed instructions.

Code Signing (Optional)

To enable code signing, add these secrets in your GitHub repository settings:

• TAURI_SIGNING_PRIVATE_KEY - Private key content
• TAURI_SIGNING_PRIVATE_KEY_PASSWORD - Private key password

The build will work without these secrets, but the installer won't be signed.

Multi-Platform Support

To enable macOS and Linux builds, uncomment the corresponding platform configurations in .github/workflows/release.yml.

Recommended IDE Setup

• VS Code
• Tauri
• rust-analyzer

License

MIT