Contributing

Open source

Gearbox Relay is Apache 2.0. The desktop client, mobile apps, and core engine are all public on GitHub. No hidden components. No encrypted blobs only we control.

View on GitHub

Development quick start

pnpm install
cargo build
pnpm tauri dev

Build commands

cargo tauri dev
cargo tauri build
cargo clippy
cargo fmt --check
cargo test --workspace
pnpm dev
pnpm build
pnpm lint
pnpm test

Architecture

The project is organized into several crates:

• React frontend in src/
• Rust backend in src-tauri/src/
• Shared core library in relay-core/
• Flutter mobile app in relay_mobile/
• AI benchmark harness in relay-bench/

Coding conventions

• Commands return Result types — use thiserror for domain errors
• React components use named exports only, state in local hooks
• AI output parsers must use multi-layer defensive parsing
• Never commit env files or credentials
• Never change the sync encryption scheme without a security review