anathema

Crates.ioanathema
lib.rsanathema
version0.2.11
created_at2022-08-04 18:02:21.161279+00
updated_at2025-08-15 12:29:50.975115+00
descriptionCreate beautiful, easily customisable terminal applications
homepagehttps://github.com/togglebyte/anathema
repositoryhttps://github.com/togglebyte/anathema
max_upload_size
id638855
size11,994,585
Togglebit (togglebyte)

documentation

https://togglebyte.github.io/anathema-guide/

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_

Commit count: 524

cargo fmt