docs.rs failed to build xengui-0.2.2
Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.

Visit the last successful build: xengui-0.2.1

XenGui: a reactive GUI library in pure Rust

Live web demo

XenGui (pronounced /ˈzɛn.ɡuː.aɪ/ | Zen-goo-eye) is a reactive rendering GUI implementation in pure Rust, built on the wgpu graphics API and winit window management. It combines a hooks-based reactive model with a Flexbox/Grid layout engine (powered by taffy) and a batched wgpu rendering pipeline, running natively on Windows, macOS, and Linux, as well as in the browser via WebAssembly.

[!IMPORTANT] XenGui is currently an early development release. APIs are still evolving and may change without notice between versions. Use with caution in production projects and expect breaking changes until a stable 1.0.0 release.

Features

Reactive state - React-style hooks (use_state, component) drive re-renders without a virtual DOM diffing framework bolted on top.
Flexbox & Grid layout - Full CSS-like layout via taffy, including flex direction, wrapping, alignment, gaps, and grid tracks.
GPU-accelerated rendering - Rects, text, and images are batched and drawn through dedicated wgpu pipelines.
Declarative styling - A CSS-like Style/StyleBuilder API covering colors (including OKLCH), borders, typography, spacing, and more.
Built-in widgets - View, Label, Button, and Image, each with hover/pressed/disabled style variants.
Interaction system - Unified handling of hover, click, focus, and keyboard events across widgets.
Cross-platform - Native targets (Windows, macOS, Linux) and WebAssembly from a single codebase.

Example

Button::new()
    .label("Increment")
    .font_size(16)
    .color(Color::NEUTRAL_500)
    .background(Color::NEUTRAL_200)
    .border(Border::new(1, Color::NEUTRAL_200, Length::px(8.0)))
    .padding(Edges::only(9, 4, 9, 7))
    .on_click(move |_ctx| set_counter.set(counter + 1))
    .hover_style(|s|
        s

            .background(Color::NEUTRAL_200)
            .border(Border::new(1, Color::NEUTRAL_300, Length::px(8.0)))
            .color(Color::NEUTRAL_600)
    );

Installation

Cargo.toml

[dependencies]

xengui = "0.2.2"

Quick Start

use xengui::*;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let config = AppConfig {
        title: "My XenGui App".into(),
        width: 640,
        height: 480,
        position: WindowPosition::Center,
        ..Default::default()
    };

    let mut app = App::new(config);

    app.render(|| {
        let (counter, set_counter) = use_state::<i32>(0);

        Box::new(
            View::new()
                .display(Display::Flex)
                .flex_direction(FlexDirection::Column)
                .align_items(AlignItems::Center)
                .justify_content(JustifyContent::Center)
                .width(Length::Percent(100.0))
                .height(Length::Percent(100.0))
                .background(Color::WHITE)
                .child(
                    Label::new()
                        .label(format!("Count: {counter}"))
                        .font_size(20)
                        .color(Color::NEUTRAL_700)
                )
                .child(
                    Button::new()
                        .label("Increment")
                        .padding(Edges::symmetric(12, 8))
                        .background(Color::NEUTRAL_200)
                        .on_click(move |_ctx| set_counter.set(counter + 1))
                )
        )
    });

    app.run()?;
    Ok(())
}

Run it with:

cargo run

For WebAssembly targets, build and serve with Trunk:

trunk serve

xengui 0.2.2