A desktop application starter using the libraries and technologies:

• Rust

  • Tauri v2 as the desktop application framework.
  • Tauri Store Plugin for persistence.
  • Tauri Log Plugin for logging.
  • Tauri OS Plugin for platform detection.
  • CrabNebula DevTools for development.

• Vue.js 3

  • Shadcn Vue + Tailwind CSS v4 for components.
  • Vue Router for application routing.
  • Vue I18n for internationalization.
  • Pinia for state management.

• AI Support

  • Tauri Pilot lets AI agents inspect, interact with, and debug Tauri applications in real-time

• VS Code + Volar + Tauri + rust-analyzer

Follow Tauri's prerequisites guide to setup your development environment.

Then rename all instances of tauriv2-vue-desktop-starter and tauriv2_vue_desktop_starter to your app name.

If you want to replace the package manager update:

• The build configuration in tauri.conf.json
• Update the following steps in .github/workflows/publish-to-auto-release.yml:
  • Install pnpm
  • Install Node.js
  • Install frontend dependencies
• Update the following steps in .github/workflows/test-build-only.yml:
  • Install pnpm
  • Install Node.js
  • Install frontend dependencies

Install dependencies with pnpm install

For Desktop development, run: pnpm tauri dev

Vue I18n

Create a new JSON file in the locales directory with the appropriate translations and the locale as the filename.

Then update the supportedLanguages function in lib/config.ts to include the new language.

Tauri Store Plugin stores settings.json at:

macOS: ~/Library/Application Support/com.github.tauriv2-vue-desktop-starter

Linux: ~/.local/share/com.github.tauriv2-vue-desktop-starter

• Native-feel CSS: the global CSS that makes the WebView feel native, plus cross-webview gotchas
• Linux: native decorations, .deb/.rpm vs AppImage, and fixes for blank windows on some GPUs
• Rust commands: where commands run and how to avoid freezing or crashing the app

Tauri CLI provides an icon command pnpm tauri icon which takes an image path and generates icon files for your application.

Contributions are welcome! Feel free to:

• Open issues for bugs or feature requests
• Submit pull requests for improvements
• Provide feedback on existing features
• Suggest documentation improvements
• Help with translations

Tauri v2 Deployment Guide

To build a binary, run:

pnpm tauri build

This repo is currently setup to create a release on Github when you merge to the release branch. See https://github.com/tauri-apps/tauri-action/tree/dev.

If you are using the signing identity - for macOS, when you first download and run the application, you will have to go to System Settings > Privacy & Security and allow your app to run. See tauri-apps/tauri-action/issues/824 & support.apple.com/open-a-mac-app-from-an-unidentified-developer.

On Linux, recommend the .deb or .rpm to users and offer the AppImage as a portable fallback. See docs/linux.md.