mayrain1999 / tauri-react-template-app

Tauri + React + Vite Template

Simple project template for Tauri and React.

Features

• React / TypeScript frontend
  • ESLint + Prettier configured
  • Tailwind CSS w/ PostCSS configured
• Simple and fast Vite config w/ HMR in development and optimizations for production builds
• Github Actions for testing and building\release

Setting Up

1. Install Tauri Prerequisites
2. Clone and install dependencies (this template uses pnpm by default):

pnpm i

Usage

A Tauri app has at least two processes:

• the Core Process (backend, or main process in Electron terminology), and
• the WebView process (frontend, or renderer in Electron)

🦢 Frontend (TS, PnPM)

Running Development Server

Both back- and frontend start with a single command:

pnpm dev

Testing

pnpm test

🦀 Backend (Rust, Cargo)

Backend code lives in src-tauri/ (Following commands are to be run from there.)

Finding Outdated Rust Dependencies

If you have cargo-outdated installed:

cargo outdated

Upgrading Rust Dependencies

If you have cargo-edit installed:

cargo upgrade

Debugging

• The dev command has by default RUST_BACKTRACE=1 set which makes Rust output full backtraces to the console. (Remove it from the package.json command if you don't want it).
• If you use VS Code, you can debug Rust code with the included Debug Tauri config.

Building and releasing

Building

The project has GitHub Actions set up which will automatically test and build your app with every push and PR. For building manually:

pnpm build

Releasing a new version

1. Bump version number (In package.json, and src-tauri/tauri.conf.json)
2. Run pnpm check to update Cargo.lock
3. Tag the commit you want to release with vX.Y.Z
4. Edit the release notes and push (also tags!)
5. Github workflow will automatically build a new draft release for this version. Publish when ready 🎉