WidgetKit

language: English, Russian

Modular Rust library for building desktop widgets.

Current scope: software 2D rendering on Windows with a demand-driven redraw model and an internal render pipeline behind the public Canvas API.

Core assembly: Widget + Canvas + WindowsHost + WidgetApp.

For the full release history, see CHANGELOG.md.

Overview

Canvas — public drawing API
rendering goes through an internal command pipeline
the runtime owns widget lifecycle, scheduler, tasks, and redraw invalidation
the Windows host supports decorated and frameless windows

Quick Start

use widgetkit::prelude::*;

fn main() -> widgetkit::Result<()> {
    WidgetApp::new()
        .widget("clock", ClockWidget)
        .host(
            WindowsHost::new()
                .with_size(Size::new(360.0, 135.0))
                .with_standard_top_bar(true),
        )
        .renderer(SoftwareRenderer::new())
        .run()
}

Example Widget

use widgetkit::prelude::*;

struct MyWidget;

impl Widget for MyWidget {
    type State = ();
    type Message = ();

    fn mount(&mut self, _ctx: &mut MountCtx<Self>) -> Self::State {}

    fn render(&self, _state: &Self::State, canvas: &mut Canvas, _ctx: &RenderCtx<Self>) {
        canvas.clear(Color::rgb(14, 17, 22));
        canvas.save();
        canvas.clip_rect(Rect::xywh(12.0, 12.0, 220.0, 72.0));
        canvas.round_rect(
            Rect::xywh(12.0, 12.0, 220.0, 72.0),
            16.0,
            Color::rgb(30, 36, 48),
        );
        canvas.text(
            Point::new(24.0, 28.0),
            "Hello",
            TextStyle::new().size(16.0),
            Color::rgb(127, 160, 255),
        );
        canvas.circle(Point::new(206.0, 28.0), 6.0, Color::rgb(127, 160, 255));
        canvas.restore();
    }
}

Examples

cargo run --example clock --features "windows canvas"

cargo run --example pulse --features "windows canvas"

With the Tokio-backed task runtime:

cargo run --example clock --features "windows canvas runtime-tokio"

Features

canvas
windows
runtime-tokio

[dependencies]

widgetkit = { version = "0.2.1", default-features = false, features = ["windows", "canvas"] }

Workspace Layout

widgetkit/
  crates/
    widgetkit
    widgetkit-core
    widgetkit-runtime
    widgetkit-render
    widgetkit-host-windows

widgetkit - top-level facade crate
widgetkit-core - geometry, colors, ids, errors, host events
widgetkit-runtime - lifecycle, scheduler, tasks, redraw coordination
widgetkit-render - Canvas, text styles, software renderer
widgetkit-host-windows - Windows host built on winit and softbuffer

Roadmap

stable window sizing and configuration APIs
richer image and text pipelines
declarative UI and layout
broader input model
GPU renderer backend
hybrid and web-backed integration paths

License

MIT

widgetkit-render 0.2.1