vasfvitor/tauri-devtools

Inspect and Debug your Tauri applications in style 💃

Devtools for Tauri

Inspect, monitor, and understand your Tauri application with ease.

• Easy Integration: With just a few lines of code, enable detailed event logging and metadata extraction for your application.
• Rich Insights: Get insight into what your app is doing, Performance, Errors, Warnings, everything is available at a glance.
• And more: This project is actively worked on, and we are open to hear your ideas, check out the Upcoming Features issue for details.

Getting Started

Ensure you have Tauri set up correctly. Then install the Rust instrumentation from crates.io:

cargo add tauri-plugin-devtools

You also have to use Tauri 1.5.3 (or later) and enable the tracing feature, so your Cargo.toml file should look as follows:

[dependencies]
devtools = "0.3.0"
tauri = { version = "1.5.3", features = ["tracing"] }
[build-dependencies]
tauri-build = "1.5.0"

Then add the following snippet to your tauri initialization code:

fn main() {
    // This should be called as early in the execution of the app as possible
    #[cfg(debug_assertions)] // only enable instrumentation in development builds
    let devtools = devtools::init();

    let builder = tauri::Builder::default();

    #[cfg(debug_assertions)]
    let builder = builder.plugin(devtools);

    builder
        .run(tauri::generate_context!("./tauri.conf.json"))
        .expect("error while running tauri application");
}

And then run your app as usual, if everything is set up correctly devtools will print the following message:

You can click or copy & paste the link into your browser to open up the UI. Alternatively you can navigate to https://devtools.crabnebula.dev and connect from there.

Features

Console

The Console tab lets you quickly and conveniently see what your app is doing. Any errors, warnings or other messages produced by your code, Tauri or your dependencies will show up here.

Calls

Commands are at the core of your Tauri app, and the Calls tab is designed to let you debug and troubleshoot any issues that you might have. It will display arguments and returns for each command as well as a detailed performance breakdown of exactly how much processing time your command spent on what.

Config Viewer

The Config Viewer will present you with a detailed breakdown of your Tauri configuration and in the future also include warnings, tips and hints.

License

The Instrumentation (i.e. the folders /wire and /devtools) is licensed under either of Apache License, Version 2.0 or MIT license at your option.

All other code is licensed under the PolyForm Noncommercial License 1.0.0.

⚠️ Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project by you, shall be licensed as above, without any additional terms or conditions.