#ui-framework #widgets #frui #interface #building #local-key #developer-friendly

nightly frui_core

Core functionality of Frui UI framework

1 unstable release

0.0.1 Sep 30, 2022

#2 in #developer-friendly

42 downloads per month
Used in 2 crates

MIT/Apache

115KB
3K SLoC

Frui

Reading: "Fru–" as in "fruit" and "–i" as in "I am".

Latest version MIT Apache Discord

What is Frui?

Frui is a developer-friendly UI framework that makes building user interfaces easy and productive. It's inspired by Flutter architecture and is written in Rust!

For an introduction see the announcement.

Example

#![feature(type_alias_impl_trait)]

use frui::prelude::*;

#[derive(ViewWidget)]
struct App<'a>(&'a str);

impl ViewWidget for App<'_> {
    fn build<'w>(&'w self, _: BuildCx<'w, Self>) -> Self::Widget<'w> {
        Center::child(Text::new(format!("Hello, {}!", self.0)))
    }
}

fn main() {
    run_app(App("World"));
}

Warning

Frui is an experimental framework and is not suitable for building real applications. It is more of a proof of concept and an exploration of new ideas, rather than a fully-fledged and reliable tool. While it may have some interesting implications and possibilities, it is not yet ready for production use and the development efforts on it are rather sporadic. It is currently not optimized and some important features have not been implemented.

To compile it you will need to install the latest version of nightly Rust.

Feel free to try it out!

Features

Ok, what's in there?

  • Basic widgets:
    • ViewWidget
    • InheritedWidget
    • RenderWidget
  • Impls:
    • WidgetState
    • RenderState
    • ParentData
  • Preserving state:
    • LocalKey
    • Position in children list
  • Basic event detectors:
    • KeyboardEventDetector
    • PointerListener
    • PointerRegion
  • Basic widgets:
    • Text
    • Center
    • Row
    • Column
    • Flex
    • Stack
    • SizedBox
    • LimitedBox
    • ConstrainedBox

For more features see examples.

🦀 Counter - Example

Obligatory crab counter! From examples/crab_counter.rs.


#![feature(type_alias_impl_trait)]

use frui::prelude::*;

mod misc;
use misc::Button;

#[derive(ViewWidget)]
struct CrabCounter;

impl WidgetState for CrabCounter {
    type State = isize;

    fn create_state(&self) -> Self::State { 0 }
}

impl ViewWidget for CrabCounter {
    fn build<'w>(&'w self, cx: BuildCx<'w, Self>) -> Self::Widget<'w> {
        Column::builder()
            .space_between(60.0)
            .main_axis_size(MainAxisSize::Max)
            .cross_axis_size(CrossAxisSize::Max)
            .main_axis_alignment(MainAxisAlignment::Center)
            .cross_axis_alignment(CrossAxisAlignment::Center)
            .children((
                Text::new(format!("{} 🦀", *cx.state()))
                    .size(100.0)
                    .weight(FontWeight::BOLD),
                Row::builder()
                    .space_between(10.0)
                    .children((
                        Button {
                            label: Text::new("+").size(30.),
                            on_click: || *cx.state_mut() += 1,
                        },
                        Button {
                            label: Text::new("-").size(30.),
                            on_click: || *cx.state_mut() -= 1,
                        },
                    )),
            ))
    }
}

fn main() {
    run_app(CrabCounter);
}

screenshot of application running above code

Crab counter running on MacOS

Credits

Frui was inspired by Flutter's widget architecture and API, and builds upon the work done in Druid, which powers much of the back-end and has influenced the implementation of many widgets. The contributions of both Flutter and Druid were essential to the development of Frui, and for those – thank you!

License

All code in this repository is dual-licensed under either:

Dependencies

~4.5–7MB
~134K SLoC