Requirements#

Helmor is built with Tauri v2, React, Vite, TypeScript, Rust, and a Bun-based sidecar. Use Bun 1.3 or newer for project scripts.

Install dependencies#

bun install

The postinstall step also installs sidecar dependencies.

Project layout#

• src/ contains the React frontend.
• src-tauri/ contains the Rust Tauri backend.
• sidecar/ contains the Bun process that talks to agent providers.

Run the desktop app#

bun run dev

This starts the Tauri app and the Vite frontend used by the desktop webview.

Common checks#

bun run typecheck
bun run lint
bun run test

Run focused checks while developing, then run the broader suite before shipping shared behavior.