Repository navigation
Build and debug
Install Node.js 20 or later, the Rust stable toolchain, and the system dependencies required by Tauri for your platform. The Tauri prerequisites page lists the platform-specific packages.
Install frontend dependencies once:
npm installStart the Tauri development app:
npm run tauri:devTo build a release bundle:
npm run tauri:buildnpm run build
npm run check:translations
npm run check:rust
npm run test:frontend
npm run test:rustnpm run build runs TypeScript checking and the Vite production build. Translation validation checks that language JSON files have the same keys as en.json. Rust check and test scripts use the manifest in src-tauri/Cargo.toml.
Start with the task's console in the app. Backend messages and Pulsar Bridge output are associated with task IDs, and the frontend queue event handler records task updates for the console. When reporting a failure, include the task type, operating system, steps to reproduce it, and the relevant console output. Remove private URLs, cookies, or other sensitive data first.
For a command that fails before a task reaches the queue, inspect the Tauri invoke error in the frontend console and the Rust output from the development process. For startup requirement issues, check the startup and version-check code in src-tauri/src/startup/.
Frontend unit tests are colocated with the code they cover and run with Vitest. Rust tests are in the Rust source tree and run with Cargo. Prefer a focused test while iterating, then run the relevant script above before opening a pull request.