TAAFT
Free mode
100% free
Freemium
Free Trial
Deals

Anathema

togglebyte / anathema

TUI library in Rust with a custom templating language and runtime

347 19 Language: Rust License: MIT Updated: 4mo ago

README

Anathema

The Guide

Crates.io
Docs.rs

Anathema is a library for building text user interfaces using composable components, with a custom markup language.

It was created with the intent to give developers a fast and easy way to build text user interfaces
(TUIs) and ship the template(s) alongside the application, giving the end user the option to customise the application to their liking.

By separating the layout from the rest of the application,
reducing the amount of code needed to express your design,
and featuring hot reloading it becomes incredibly fast to iterate over the design.

Anathema has a single pass layout inspired by Flutter and Swift UI.

Supported features

  • Hot reloading
  • Reactive templates
  • Template functions
  • Third party components
  • Distributable templates
  • Message passing supports async
  • Message passing between components via an emitter

Note Anathema should be considered beta for now.

See The Guide for getting started.

Example component

struct MyComponent;

impl Component for MyComponent {
    type State = MyState;
    type Message = ();

    fn on_tick(
        &mut self,
        state: &mut Self::State,
        children: Children<'_, '_>,
        context: Context<'_, '_, Self::State>,
        dt: Duration,
    ) {
        *state.value.to_mut() += 1;
    }
}

#[derive(State)]
struct MyState {
    counter: Value<u32>,
}

Example template

vstack
    text "the counter is " state.counter
    text "the counter will be " state.counter + 1
    if state.count > 10
        text "the counter is more than ten"

output

the counter is 11
the counter will be 12
the counter is more than ten

Screenshots etc.

Bubbles by Jyn ASCII

cinema

Markdown reader by Doddi

Markdown reader by Doddi

Screenshot by Jyn

Bunny rpg by Jyn

Twitch UI by Twitch user s9tpepper_

Twitch ui by Twitch user s9tpepper_
0 AIs selected
Clear selection
#
Name
Task