Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fwcd/nuit
Declarative cross-platform UI framework for Rust that uses native controls
https://github.com/fwcd/nuit
gui rust swift swiftui ui
Last synced: 5 days ago
JSON representation
Declarative cross-platform UI framework for Rust that uses native controls
- Host: GitHub
- URL: https://github.com/fwcd/nuit
- Owner: fwcd
- License: mpl-2.0
- Created: 2023-03-19T02:29:10.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-09T16:59:08.000Z (4 months ago)
- Last Synced: 2024-12-16T02:04:47.322Z (12 days ago)
- Topics: gui, rust, swift, swiftui, ui
- Language: Rust
- Homepage:
- Size: 811 KB
- Stars: 45
- Watchers: 7
- Forks: 2
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Nuit
[](https://github.com/fwcd/nuit/actions/workflows/build.yml)
A declarative, cross-platform UI framework for Rust that uses native controls.
| Crate | Description | Version | Docs |
| - | - | - | - |
| [nuit](./nuit) | Umbrella crate for the framework | [](https://crates.io/crates/nuit) | [](https://docs.rs/nuit) |
| [nuit-bridge-adwaita](./nuit-bridge-adwaita) | Adwaita backend (Linux, macOS) | [](https://crates.io/crates/nuit-bridge-adwaita) | [](https://docs.rs/nuit-bridge-adwaita) |
| [nuit-bridge-swiftui](./nuit-bridge-swiftui) | SwiftUI backend (macOS, iOS) | [](https://crates.io/crates/nuit-bridge-swiftui) | [](https://docs.rs/nuit-bridge-swiftui) |
| [nuit-core](./nuit-core) | Core structures and traits | [](https://crates.io/crates/nuit-core) | [](https://docs.rs/nuit-core) |
| [nuit-derive](./nuit-derive) | Derive macros | [](https://crates.io/crates/nuit-derive) | [](https://docs.rs/nuit-derive) |
## About the Project
The API takes inspiration from contemporary reactive frameworks like SwiftUI, Xilem and React. A central design goal is to avoid using too much macro magic and instead heavily leverage associated types, traits and generics.
A simple hello world program in Nuit takes only a single line:
```rust
nuit::run_app(Text::new("Hello world!"));
```
For a more elaborate example, check out [the section below](#example).
> [!IMPORTANT]
> Nuit is still experimental with a rapidly evolving API. As such, treat this library as a sandbox rather than as a finished product, especially if you intend to write an app with it.
>
> While the SwiftUI backend can be considered the reference implementation of the Nuit API, the Adwaita backend is still in early development and does not cover the full API surface yet.
>
> The library also requires a nightly Rust toolchain due to its use of a number of unstable compiler features:
>
> - [impl Trait in type aliases](https://github.com/rust-lang/rust/issues/63063)
> - [associated type defaults](https://github.com/rust-lang/rust/issues/29661)
> - [macro metavariable expressions](https://github.com/rust-lang/rust/issues/83527)
> - [`let` chains](https://github.com/rust-lang/rust/issues/53667)
> - [reentrant locks](https://github.com/rust-lang/rust/issues/121440)
>
> With `rustup` this can be configured conveniently on a per-directory basis `rustup override set nightly` or, as in this repository, automatically with a [`rust-toolchain.toml`](rust-toolchain.toml).
## Example
```rust
use nuit::{prelude::*, Button, Text, VStack};
#[derive(Bind, Default)]
struct CounterView {
count: State,
}
impl View for CounterView {
type Body = impl View;
fn body(&self) -> Self::Body {
let count = self.count.clone();
VStack::from((
Text::new(format!("Count: {}", count.get())),
Button::with_text("Increment", move || {
count.set(count.get() + 1);
})
))
}
}
fn main() {
nuit::run_app(CounterView::default());
}
```
Running this example with
```sh
cargo run --example counter
```
will launch the app with the platform-specific default backend, e.g. SwiftUI on macOS:
Using the Adwaita/GTK4 backend the app looks as follows:
> [!TIP]
> On platforms that support multiple backends (currently only macOS) you can explicitly choose a backend via the `NUIT_BACKEND` environment variable:
>
> ```sh
> NUIT_BACKEND=adwaita cargo run --example counter
> ```