zaxis
Typed themes resolve into the existing immediate mode Style:
context.set_theme;
ui.with_theme(&theme, |ui| ...) and ui.with_style(&overrides, |ui| ...) style
local subtrees and their popups. Explicit component overrides survive accent and
density changes; legacy set_style installs its exact value. Run
cargo run --example themes. See Style and Theme
for states, painters and migration.
An event-driven immediate mode GUI for desktop tools, written in Rust. Uses winit and wgpu, with retained interaction state and cached CPU/GPU geometry.
0.0.1 Blinking is the first development release. Public APIs may change between development releases. CI checks Windows, Linux, and macOS; native GPU and desktop behavior still needs platform-specific testing.
Why zaxis when egui exists?
zaxis belongs in the same immediate-mode UI niche as egui. It is an independent library, with its own API and implementation. Its goal is a convenient workflow for desktop tools: a short path from application state to a running window, ready-to-use motion, and automatic resource handling.
Implement App::update, then call zaxis::run(app). The default runner owns the
event loop, repaint scheduling, and GPU recovery. Widgets come with hover and reveal
transitions; custom motion uses typed tweens, springs, keyframes, and sequences.
The animation engine retains channels and schedules their next repaint, so ordinary
animations do not need a separate clock or update loop in application code.
egui also has a compact runner through eframe and built-in animation helpers. The difference is how the common tasks are packaged, rather than a claim that zaxis is universally better or a replacement for egui.
| Task | zaxis | egui / eframe |
|---|---|---|
| Start a native app | zaxis::run(app) with defaults; run_with_options for customization |
eframe::run_native with app name, options, and an app-creation closure |
| Animate values | Typed transitions, tweens, springs, keyframes, and track composition with automatic repaint deadlines | Context animation helpers for booleans and scalar values, including easing helpers |
| Load local images / SVG | Built-in async loading through ui.image(source); no loader registration |
egui_extras loaders with format features and loader installation |
| Target applications | Desktop tools; the default runner owns one native window | Native, web, and game-engine integrations |
This compares the everyday API paths with egui/eframe 0.36.2, not rendering speed or overall feature coverage. zaxis is an early development release with a smaller scope. Choose the workflow that fits your application.
Quick start
Requires Rust 1.90 or newer. Once published on crates.io:
[]
= "=0.0.1"
Before publication, use zaxis = { git = "https://github.com/nihmadev/zaxis" }.
use ;
;
Documentation — installation, components, layout, input, repaint scheduling, custom hosts, renderer, and drawing protocol.
| Task | Documentation source |
|---|---|
| Add the library | Installation |
| Create an application | First application |
| Edit or drag typed numbers | NumberInput / DragValue |
| Use controls | Components |
| Scroll long content and virtual lists | ScrollArea |
| Compose forms and data tables | Grid, Table |
| Fold arbitrary content and browse large hierarchies | CollapsingHeader, TreeView |
| Add transitions or a custom spring | Animation |
| Integrate an event loop | Custom host |
| Find a public type or method | API index |
| Build or publish the documentation | Site setup |
Run the examples
Clone the Git repository before running the examples and benchmarks.
Stable Rust 1.90 or newer, a desktop display, and a functioning GPU backend are required.
The demo/settings/integration examples use immediate presentation; append
-- --vsync for synchronization. grid_table uses Immediate presentation.
Animation examples use the default Vsync runner.
CollapsingHeader::new(id_source, caption).show(ui, body) folds arbitrary measured
content and supports independent right actions. TreeView::new(id_source).show(ui,
&model) uses application-owned TreeModel, stable node Ids, keyboard navigation,
lazy request events and fixed-height virtualization. Both support controlled state
and local themes. Tree revision explicitly invalidates its expanded-row cache;
reveal_node opens a parent path and focuses/scrolls on an explicit request.
Built-in hover and reveal use 160 ms Quad Out; Ui::tab_pages uses directional
280 ms Quint Out slides. Style::motion controls duration, easing and reduced
motion. Stable animation channels run on monotonic time, sleep during delay and
stop scheduling when settled or hidden. Applications can implement Interpolate
and Animation<T> or provide closures without modifying zaxis.
Images
Built-in images need no loader installation: ui.image("assets/photo.jpg"),
ui.image(include_bytes!("assets/logo.svg")), or
Image::new(ImageSource::rgba([width, height], pixels)). PNG/JPEG/WebP/BMP/SVG work
out of the box; default features also include GIF/TIFF (first animation frame only).
Loading and SVG rasterization run on bounded background workers with automatic runner
wakeup, bounded CPU/GPU caches and explicit update/reload/release operations.
See image API, memory limits and custom host integration.
Run cargo run --release --example images -- --smoke-test for the public API example.
The measurement report includes CPU/GPU stage distributions and sustained scroll/reload process-memory measurements.
Optional features
Default features include bundled-emoji, image-gif, and image-tiff.
The complete Noto Color Emoji font is shipped in the separate zaxis-emoji crate.
Splitting the package keeps each crates.io upload small enough; it does not reduce
default download size or memory use. It also lets applications omit the font:
[]
= { = "=0.0.1", = false, = ["image-gif", "image-tiff"] }
This keeps the optional image codecs and uses system fonts for emoji. Emoji coverage and color rendering then depend on installed fonts. PNG/JPEG/WebP/BMP/SVG, text shaping, and desktop backends remain available without default features.
Benchmark
The benchmark opens a native GPU window, runs Vsync and Immediate, injects pointer and keyboard interactions, and asserts the resulting state and cache behavior. It covers widgets, window drag/resize, layouts, text, shapes, blur, DPI, repaint deadlines, object lifecycle, and geometry/texture uploads. JSON results include p50/p95/p99, throughput, frame budgets, mesh sizes, and CPU/GPU activity counters.
Use --quick for a smoke run, --cpu-only without a display, or --gpu-wait to
measure frames through GPU completion. Results default to target/benchmark.json.
See benchmark details or
cargo bench --bench performance -- --help for filtering, load sizes and budgets.
Contributing and support
See CONTRIBUTING.md for checks and contribution guidelines, CHANGELOG.md for releases, and RELEASING.md for publishing. Report problems through GitHub Issues or contact @nihmadev on Telegram. For sensitive vulnerabilities, contact Telegram privately; see SECURITY.md.
License
Source: MIT. Bundled Inter (Regular, Medium, SemiBold, Bold), JetBrains Mono (Regular, Bold) and Noto Color Emoji fonts: Inter OFL, JetBrains Mono OFL, Noto Emoji OFL. Lucide-derived icons: ISC. Include the corresponding licenses when redistributing these assets.