sanguine

Create dynamic, performant TUI applications in Rust.

Sanguine was created from the need for a library tailored for complex TUI applications such as text editors and terminal multiplexers. The Rust ecosystem contains many great crates for building TUI apps, but many are geared towards small dashboard-like apps and implement immediate-mode rendering or struggle with mouse events.

Sanguine implements a tree-based layout API that can be updated at runtime, with a custom constraint algorithm geared towards rendering to the terminal. Layout results are cached between renders for performance, and are only recomputed when the layout is changed. Widgets can be nested and mouse events are handled properly for widgets at any depth - widgets only need to handle mouse events based on local position. Widgets can optionally specify a cursor location to allow for implementations of text editor windows and more.

It is built on top of Termwiz' BufferedTerminal, which optimizes terminal writes to maximize performance.

Features:

• Dynamic, Tree-based layout API
• Extensible widget trait
• First-class mouse events support
  • Automatic propagation
  • Hover and click support
• Global and widget-local event handlers
• Generic API
  • Custom user event type for message passing
  • Custom state type for core app state
• Focus
  • Switch focus by direction or directly

Demo

demo

$ git clone git@github.com:willothy/sanguine.git

$ cd sanguine

$ cargo run --example demo