Vizia is a declarative GUI framework for the Rust programming language.
A simple counter application. Run with cargo run --example counter
.
// Define some model data
#[derive(Lens)]
pub struct AppData {
count: i32,
}
// Define events to mutate the data
pub enum AppEvent {
Increment,
}
// Describe how the data can be mutated
impl Model for AppData {
fn event(&mut self, _: &mut Context, event: &mut Event) {
event.map(|app_event, _| match app_event {
AppEvent::Increment => {
self.count += 1;
}
});
}
}
Application::new(|cx| {
// Build the model data into the tree
AppData { count: 0 }.build(cx);
HStack::new(cx, |cx| {
// Declare a button which emits an event
Button::new(cx,
|cx| cx.emit(AppEvent::Increment),
|cx| Label::new(cx, "Increment")
);
// Declare a label which is bound to part of the model, updating if it changes
Label::new(cx, AppData::count)
.width(Pixels(50.0));
})
.child_space(Stretch(1.0))
.col_between(Pixels(50.0));
})
.title("Counter")
.inner_size((400, 100))
.run();
- Multiplatform (Windows, Linux, MacOS, Web)
- Declarative API
- Reactive event-driven data system
- Flexible layout engine, powered by morphorm
- GPU rendering, powered by femtovg
- CSS styling with hot reloading
- Property animations
- Audio plugin GUI development
A full list of examples is included in the repository.
To run an example with the winit (default) windowing backend:
cargo run --release --example name_of_example
To run an example with the baseview windowing backend:
cargo run --release --example name_of_example --no-default-features --features baseview
To run an example as a web application, first ensure that the wasm32-unknown-unknown
toolchain is installed:
rustup target add wasm32-unknown-unknown
Then run an example with the following:
cargo run-wasm --release --example name_of_example
NOTE - Some examples are not compatible with the web target.
For help with vizia, or to get involved with contributing to the project, come join us on our discord.
Vizia is licensed under MIT.
Fonts used in Vizia:
- Roboto licensed under Apache license.
- Open Sans Emoji licensed under Apache license.
- Amiri licensed under Open Font License.
- Entypo licensed under CC BY-SA 4.0.
- Material Icons licensed under Apache license.
Vizia logo designed by Lunae Somnia.