All posts

Docs1 min read

Build GitLane from source

bun, the pinned Rust toolchain, and your platform's Tauri dependencies — then tauri build, not bun run dev alone.

Prerequisites

  • bun — the package manager (the lockfile is bun.lock; don't use npm or yarn)
  • The Rust toolchain — the repository pins its version, including rustfmt and Clippy, in rust-toolchain.toml
  • git
  • Your platform's Tauri system dependencies — webkit2gtk on Linux, Xcode Command Line Tools on macOS, MSVC Build Tools + WebView2 on Windows

Build and develop

bun install
bun run tauri build

Source builds don't use the in-app updater — pull and rebuild to update. They also don't trip any signing warnings, because you compiled the binary yourself.

bun run tauri dev    # launch the app with hot reload

bun run dev starts the Vite dev server without the Rust process, so every invoke() call into the backend fails. Don't use it alone. The first tauri dev run does a full Rust build and takes roughly a minute.

Checks

Frontend:

bunx tsc --noEmit
bun run test
bun run lint

Rust, from src-tauri:

cargo check
cargo fmt --all -- --check
cargo clippy --all-targets --all-features -- -D warnings

Typechecks are the primary safety net — test coverage is still partial.

Good to know

bun run dev is the Vite server only. Launch the app with bun run tauri dev or you will watch every backend call fail.

Bug reports and feature requests go in issues. CONTRIBUTING.md and docs/rules/ cover how changes stay consistent.

Full walkthrough: Build from source.

Installers: Download GitLane.

Read next