pcharbon

A direct-mode Terminal UI framework for Elixir/BEAM, inspired by BubbleTea (Go) and Ratatui (Rust).

TermUI leverages BEAM’s unique strengths—fault tolerance, actor model, hot code reloading—to build robust terminal applications using The Elm Architecture.

Blue Theme Yellow Theme

Features

Elm Architecture - Predictable state management with init/update/view
Rich Widget Library - Gauges, tables, menus, charts, dialogs, and more
Efficient Rendering - Double-buffered differential updates at 60 FPS
Themable - True color RGB support (16 million colors)
Cross-Platform - Linux, macOS, Windows 10+ terminal support
OTP Integration - Supervision trees, fault tolerance, hot code reload

Installation

Add term_ui to your dependencies in mix.exs:

def deps do
  [
    {:term_ui, "~> 0.1.0"}
  ]
end

https://github.com/pcharbon70/term_ui

10 comments

#library #terminal #tui

48 3250 10

2025-12-03 18:15:04 UTC

Showing Posts 1 to 10

Show Best Posts
Show All (oldest first)
Show All (newest first)

kevinschweikert

I tried the dashboard example and the refresh did not update the view. Would that be caused by

because the state diff is the same?

Post #1

pcharbon

Yes unfortunately (or fortunately) you cant see the refresh. The rendering process uses two ETS buffers and only render a diff of the previous buffer and the next. I actually spent time trying to figure out why the refresh did not work haha

Note: you can see the past refresh by changing the theme.

Post #2

AndyL

I was able to run all of your examples - no problems. Xubuntu 24.04, Ghostty, Elixir 1.19.3, Erlang 28.2.

(yeah the refresh on the dashboard was funky for me too…)

This looks like great work BRAVO.

Post #3

fuelen

Looks very good

Post #4

Schultzer

This looks nice and clean!

Post #5

pcharbon

Yeah looked like a good idea to have a refresh on the dashboard for some reason. I was not expectint to be useless haha. Glad that it all worked, you never know when you publish.

Post #6

pcharbon

Thanks, there are more widgets I want to do and hopefully people can just contribute theirs.
I am considering adding a DSL or some templating sigil maybe.

Post #7

ghannam80

this looks very nice. I had some monitoring for some legacy systems that is using scripting like tail/sed and grep to alert people about issues based on logs. I wonder if the same can be done using it "time to explore”.

Post #8

pcharbon

You could probably easily transform your scripts to .exs and run them from inside the TUI. I could definitetly see an email library tied into it even. Its elixir so sky is the limit. If you ever make an interesting widget for it, share it back if you can.

Post #9

pcharbon

TermUI v0.2.0

New Widgets

Basic Widgets:

TextInput - Single-line and multi-line text input with cursor movement

Overlay Widgets:

AlertDialog - Modal dialog for confirmations with standard button configurations
ContextMenu - Right-click context menu with keyboard and mouse support