Skip to content

vizia/vizia

Repository files navigation

Vizia


A declarative desktop GUI framework for the Rust programming language.



Features

  • Cross-platform (Windows, Linux, MacOS)

    Build desktop applications which look and behave the same for Windows, Mac, and Linux.
  • Declarative

    Write GUI code in a declarative way in pure Rust (no DSL macros).
  • Reactive

    Views derive from application state. Change the state and the views which bind to it update automatically.
  • Flexible layout

    Create flexible layouts which adapt to changes in size. Powered by morphorm.
  • Powerful styling

    Take advantage of stylesheets with hot-reloading to fully customize the look of your application.
  • Animations

    Bring your applications to life with animations.
  • Built-in views and themes

    Utilize over 25 ready-made views as well as two built-in themes (light and dark) to get you started. Includes 4250+ SVG icons, provided by Tabler Icons.
  • Accessibility

    Make you applications accessible to assistive technologies such as screen readers, powered by accesskit.
  • Localization

    Adapt your application to different locales, including translating text with fluent.
  • Optimised rendering

    Vizia leverages the powerful and robust skia library for rendering, with further optimizations to only draw what is necessary.
  • Audio plugin development

    Vizia provides an alternative baseview windowing backend for audio plugin development, for example with the nih-plug framework.

At a Glance

A simple counter application. Run with cargo run --example counter.

use vizia::prelude::*;

// 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 is mutated in response to events
impl Model for AppData {
    fn event(&mut self, _: &mut EventContext, event: &mut Event) {
        event.map(|app_event, _| match app_event {
            AppEvent::Increment => {
                self.count += 1;
            }
        });
    }
}

fn main() {
    // Create an application
    Application::new(|cx| {

        // Build the model data into the tree
        AppData { count: 0 }.build(cx);

        // Declare views which make up the UI
        HStack::new(cx, |cx| {
          
            // Declare a button which emits an event
            Button::new(cx, |cx| Label::new(cx, "Increment"))
              .on_press(|cx| cx.emit(AppEvent::Increment));

            // Declare a label which is bound to part of the model, updating when it changes
            Label::new(cx, AppData::count).width(Pixels(50.0));
        })
        .child_space(Stretch(1.0))  // Apply style and layout modifiers
        .col_between(Pixels(50.0));
    })
    .title("Counter") // Configure window properties
    .inner_size((400, 100))
    .run();
}

Learning

Book

A quickstart guide for vizia is available here.

Docs

Auto-generated code documentation can be found here.

Examples

A 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

Baseview

To run an example with the baseview windowing backend:

cargo run --release --example name_of_example --no-default-features --features baseview

Contributing and Community

For help with vizia, or to get involved with contributing to the project, come join us on our discord.

License and Attribution

Vizia is licensed under MIT.

Vizia logo designed by Lunae Somnia.