Skip to content
Hanterill

Documentation

Project

Development

Build Hanterill from source and contribute.

Hanterill is Rust for the engine and React with TypeScript for the interface, packaged with Tauri v2.

Prerequisites

  • Rust stable toolchain (rustup)
  • Node 20 or later
  • Platform build dependencies for Tauri v2 (WebView2 on Windows, webkit2gtk on Linux, Xcode command line tools on macOS)

Build

Text
git clone https://github.com/hanterill/hanterill
cd hanterill
npm install
npm run tauri dev      # run locally
npm run tauri build    # produce a platform bundle

The bundle for your platform is written under src-tauri/target/release/bundle.

Layout

PathContents
engine/Rust diagnostic engine: transport, UDS, decoders, safety gate
src/React interface
src-tauri/Tauri shell and command bindings
docs/This documentation

Contributing

The most useful contributions are protocol traces, ECU maps and decoder corrections, especially for provisional SEA and SPA2 platforms. A trace of a real session with the VIN removed, paired with the expected values, is enough to add or fix a decoder.

Run cargo test and npm test before opening a pull request. Keep the safety gate intact: a routine or write must not become reachable without the session write flag.