Installation

Minimum setup

Choose the smallest crate that fits your use case.

Backend-agnostic core only:

[dependencies]
twill-core = "0.3"

Facade crate with the same core API:

[dependencies]
twill = "0.3"

Direct adapter crate without the facade:

[dependencies]
twill-core = "0.3"
twill-egui = "0.3"
# or twill-iced / twill-slint

MSRV: Rust 1.93.

Enable GUI backends

Enable only the backends you use:

[dependencies]
twill = { version = "0.3", features = ["egui"] }
# or
twill = { version = "0.3", features = ["iced"] }
# or
twill = { version = "0.3", features = ["slint"] }

You can combine features:

[dependencies]
twill = { version = "0.3", features = ["egui", "iced", "slint"] }

Feature notes

• twill-core stays backend-agnostic and does not require a GUI runtime.
• twill-egui, twill-iced, and twill-slint each depend only on twill-core plus their own runtime crate.
• Base twill simply re-exports twill-core; it does not require a GUI runtime until you enable a backend feature.
• egui enables egui conversion helpers only.
• iced enables the Iced adapter and the Linux windowing/runtime feature set used by this crate configuration.
• slint enables Slint conversion helpers only.

Verify installation

Run:

cargo check

If you enabled backend features, you can verify the crate builds with:

cargo check --features egui
cargo check --features iced
cargo check --features slint

If you are working in the Twill repository itself, validate the full workspace with:

cargo clippy --workspace --all-targets --all-features -- -D warnings
cargo test --workspace --all-features
cargo check --workspace --all-features --examples