icedtea 0.17.2

Native desktop widgets and chrome for iced
Documentation

icedtea

Documentation Crates.io License check Coverage

A Rust library that draws a native desktop window: buttons, lists, menus, and the chrome around them, on iced. You keep the data. Color and type follow Material Design 3 roles (m3 module). Desktop chrome is rectangular (M3 shape None).

icedtea::run! opens the window. An Action is a command you write once. The same row feeds the menu, the toolbar, shortcuts, the context menu, footer hints, and the command palette. A constructor is a function that draws one control and sends your message.

Click focuses a control. Tab walks those targets. A focused list, tree, slider, or pick owns arrows, Enter, and Space. Escape closes an open menu, pick, context menu, drawer, or cancel dialog. run! listens for keys. ActionTable::seed_quit adds ctrl+q. Lists, tables, and trees virtualize. Markdown, code, and fields select and copy through the same select contract.

Layout is Rust (pack, split_view, form). Patterns dock a list beside detail, a dialog sheet, a drawer, or a workspace of splits. Chrome follows the window direction. Tokens carry density and follow the host light/dark pair. Every drawing constructor takes A11y.

A themed icedtea window

First window

cargo add icedtea. It tracks iced 0.14. The crates.io badge above is the crate version.

The program is examples/hello.rs: a notes buffer, Save on ctrl+s, Quit on ctrl+q, a toolbar, Tab into the editor, and a status line.

icedtea::run!(
    Boot::new("Notes", "dev.example.hello"),
    Hello::new,
    Hello::update,
    Hello::view,
    Hello::theme,
)

cargo run --example hello from a checkout.

Where to look

  • Guide — first window, then a one-day task list that writes a SQLite file, then every control
  • Crate docs — widget, theme, action, layout, window, pattern
  • crates.io · source

Linux needs libxkbcommon-dev and libwayland-dev. macOS needs the Xcode command-line tools. Windows needs the MSVC build tools.