Skip to main content
Version: Next

Try Ribir

You will learn

  • How to write and start a simple Hello world! application

Install Rust

At first, you need to install Rust, you can reference the official documentation.

Create a new Ribir project

Then, open your terminal and create a new Rust project:

cargo new ribir-hello-world
cd ribir-hello-world

Next, edit the Cargo.toml file and add Ribir as a dependency:

[dependencies]
ribir = "0.3.0-alpha.4"

Or you can directly run cargo add --git "https://github.com/RibirX/Ribir" ribir to let Cargo add the latest Ribir version that is under development for you.

Start writing main.rs

Open your editor and modify the src/main.rs file to:

// main.rs
use ribir::prelude::*;

fn main() {
App::run(fn_widget! { @Text { text: "Hello World!" }});
}

Run the application

cargo run

Congratulations! You have completed your first Ribir project.

Run Ribir's built-in examples

Finally, there are some other examples in the Ribir repository, you can clone the Git repository:

git clone git@github.com:RibirX/Ribir.git
cd Ribir/Ribir

and run the examples with one of the following commands:

cargo run -p counter
cargo run -p storybook
cargo run -p messages
cargo run -p todos
cargo run -p wordle_game

Next Steps

If you're hesitant about creating UI with "DSL" and prefer to build your UI through direct function calls, before moving on to the next step, you might want to read Using Ribir without "DSL" first.