tauri-vite-vue — Vue Starter Template

SHA-256: 6e269424354b0602c36e639c98bc4692d2a6ca62e8c969dc77acbaf83197976a

2026-10-02T22:08:14.262Z

# tauri-vite-vue

(🧪 WIP) Vite + Vue Starter for [Tauri](https://tauri.app/).

> Preview: <https://tauri-vite-vue.pages.dev/>
> Docs: <>

## Prerequisites

> Windows/macOS/Linux require different environments, but [Rust](https://www.rust-lang.org/) and [Node.JS](https://nodejs.org/) are needed.

More info see [Prerequisites | Tauri](https://v2.tauri.app/start/prerequisites/).

## Try

### GitHub Template

[Create a repo from this template on GitHub](https://github.com/YunYouJun/tauri-vite-vue/generate)

### Clone to local

If you prefer to do it manually with the cleaner git history

```bash
npx degit YunYouJun/tauri-vite-vue my-tauri-app
cd my-tauri-app
pnpm i # If you don't have pnpm installed, run: npm install -g pnpm
```

## Checklist

When you use this template, try follow the checklist to update your info properly

- [ ] Change `tauri.bundle.identifier` value in `src-tauri/tauri.conf.json`
- [ ] Change the author name in `LICENSE`
- [ ] Change the title in `App.vue`
- [ ] Change the icons in `src-tauri`
- [ ] Remove the `.github` folder which contains the funding info
- [ ] Clean up the READMEs and remove routes

And, enjoy :)

## Usage

### Development

```bash
# run it and visit http://localhost:1420
pnpm dev

# run it in tauri
# RUST_BACKTRACE=1 pnpm tauri dev
pnpm tauri dev
```

```bash
# https://tauri.app/distribute/google-play/#changing-app-icon
pnpm tauri icon /path/to/app-icon.png
```

#### Android

```bash
# https://tauri.app/start/prerequisites/#android
export JAVA_HOME="/Applications/Android Studio.app/Contents/jbr/Contents/Home"
# custom
# export JAVA_HOME="/Users/yunyou/Applications/Android Studio.app/Contents/jbr/Contents/Home"
export ANDROID_HOME="$HOME/Library/Android/sdk"
export NDK_HOME="$ANDROID_HOME/ndk/$(ls -1 $ANDROID_HOME/ndk)"

rustup target add aarch64-linux-android armv7-linux-androideabi i686-linux-android x86_64-linux-android

# dev
pnpm tauri android init
pnpm tauri android dev
```

#### iOS

> [iOS | prerequisites | Tauri](https://tauri.app/start/prerequisites/#ios)

```bash
rustup target add aarch64-apple-ios x86_64-apple-ios aarch64-apple-ios-sim

brew install cocoapods
```

```bash
# .env
APPLE_DEVELOPMENT_TEAM=YOUR_TEAM_ID
```

```bash
# fist
pnpm tauri ios init

# run
pnpm tauri ios dev
```

### Build

```bash
# Build Tauri App, find it below
pnpm tauri build

# You can use `pnpm build` to build website.
```

- Windows `.msi`: `src-tauri/target/release` (only be created on Windows)
- macOS `.dmg`: `src-tauri/target/release/bundle/dmg` (only be created on macOS)
- Linux(Debian) `.deb`: `src-tauri/target/release` (only be created on Linux)

### Release

The release workflow in `.github/workflows/release.yml` builds Windows, Linux, macOS Intel, and macOS Apple Silicon bundles, then uploads them to a draft GitHub Release.

Push a version tag to trigger it:

```bash
git tag v0.1.0
git push origin v0.1.0
```

## FAQ

### Android: packageInfo is null

需为安卓 APK 签名。

```bash
keytool -genkey -v -keystore ~/upload-keystore.jks -keyalg RSA -keysize 2048 -validity 10000 -alias upload
```

```bash
# /src-tauri/gen/android/keystore.properties
storePassword=<password from previous step>
keyPassword=<password from previous step>
keyAlias=upload
storeFile=<密钥存储文件的位置，例如 /Users/<user name>/upload-keystore.jks 或 C:\\Users\\<user name>\\upload-keystore.jks>
```

> [为应用签名](https://developer.android.com/studio/publish/app-signing?hl=zh-cn)
> [安卓代码签名｜Tauri](https://tauri.app/zh-cn/distribute/signing/android/)

## Thanks

- [Tauri](https://github.com/tauri-apps/tauri)
- [Vite](https://github.com/vitejs/vite)
- [Vue](https://github.com/vuejs/core)
- [Vitesse](https://github.com/antfu/vitesse)