~/dev/terminus — zsh — 192×54 v1.0.0 · MIT

████████╗███████╗██████╗ ███╗   ███╗██╗███╗   ██╗██╗   ██╗███████╗
╚══██╔══╝██╔════╝██╔══██╗████╗ ████║██║████╗  ██║██║   ██║██╔════╝
   ██║   █████╗  ██████╔╝██╔████╔██║██║██╔██╗ ██║██║   ██║███████╗
   ██║   ██╔══╝  ██╔══██╗██║╚██╔╝██║██║██║╚██╗██║██║   ██║╚════██║
   ██║   ███████╗██║  ██║██║ ╚═╝ ██║██║██║ ╚████║╚██████╔╝███████║
   ╚═╝   ╚══════╝╚═╝  ╚═╝╚═╝     ╚═╝╚═╝╚═╝  ╚═══╝ ╚═════╝ ╚══════╝

A React-inspired TUI framework for Java 21

jdk 21 zero runtime deps 60 fps MIT github.com/P0intMaN/terminus

terminus github.com/P0intMaN/terminus

~/dev/terminus 02 / 11

// what_is_terminus

A zero-dependency TUI framework
that brings the component model
from React and Flutter to the terminal.

you compose

Components.
Layouts. State.

terminus handles

Raw mode.
ANSI. Input.

double-buffered

Diff rendering.
Zero flicker.

event loop

60 fps.
Virtual threads.

terminus 02 / 11

~/dev/terminus/examples · App.java 03 / 11

// hello_world

A complete TUI app
in ~10 lines.

// imports omitted
public class App {
  public static void main(String[] args) {
    Layout root = Layout.column().padding(1).build();

    root.add(Text.bold("My App", 0x7F77DD));
    root.addFlex(Table.builder(model, columns).build());
    root.add(statusBar);

    TerminusApp.run(root);
  }
}

terminus 03 / 11

// in_action

A live process monitor.
Virtual scrolling · sortable columns · key-driven.

terminus-demo

./run-demo.sh

terminus 04 / 11

~/io/terminus/core/components 05 / 11

// the_component_model

Everything is a Component.

Component (abstract)
├── Leaf          // renders directly
│   ├── Text
│   ├── ProgressBar
│   ├── TextInput
│   ├── Table
│   └── [your component]
└── Container
    └── Layout (row | column)
        └── gap · padding · flex

Text

Wrap, align, truncate, color. The atom.

ProgressBar

Four styles — eighths, block, ASCII, braille.

TextInput

Cursor, history, selection, kill rings.

Table

100k+ rows. Virtual scroll. Sortable.

terminus 05 / 11

// progress_bars

Four bar styles, one component.
Eighths · Block · ASCII · Braille.

ProgressBarExample

~60 fps · animated

terminus 06 / 11

~/components/Table.java 07 / 11

// virtual_scrolling

100,000 rows.
Render only what's visible.

Performance

100k+

rows supported

O(v)

visible-only render

Built-in

› Typed model, per-column extractors
› Numeric & lexical sort, multi-cycle
› Flex + fixed columns, alignment
› Selection callback, focus state

Keyboard

↑ ↓	move selection
Home / End	first / last row
PgUp / PgDn	scroll by page
s	cycle sort column
S	reverse sort direction
r	reset to original order
Enter	fire onSelect callback

terminus 07 / 11

~/architecture 08 / 11

// architecture

stdin → events → diff → ANSI.

01 · ingest

EventLoop

stdin reader on a virtual thread
BlockingQueue<Event>
UI thread drains and dispatches
Sealed: Key · Mouse · Resize · State

02 · dispatch

EventDispatcher

Chain of Responsibility
Bubbles up the focus path
focused → parent → root
onEvent() mutates state, never UI

03 · render

RenderPipeline

LayoutEngine measures + places
Renderer walks the tree
ScreenDiffer computes deltas
AnsiWriter — atomic flush

// The golden rule — render() is pure. State mutations live in onEvent(). Unidirectional data flow.

terminus 08 / 11

~/patterns 09 / 11

// design_patterns

Built on 13 classic patterns.

PATTERN	WHERE
Composite	Component / Container / Leaf
Visitor	Renderer walking the tree
Chain of Resp.	EventDispatcher
Observer	markDirty() bubbling
Builder	Every component
Template Method	LayoutEngine
Strategy	FlexConfig, TableModel

PATTERN	WHERE
Command	Event sealed hierarchy
Double Buffer	ScreenBuffer
Repository	TableModel
Facade	TerminusApp, RenderPipeline
State Machine	KeyParser
Value Object	Cell, Bounds, Constraint

terminus 09 / 11

~/ROADMAP.md 10 / 11

// roadmap

What's next.

·ScrollView — scrollable content pane

·Tree — expandable tree view

·Modal — overlay with focus trap

·Sparkline — inline mini-chart

·Mouse click routing to components

·Terminal resize live reflow

·macOS support (termios layout)

·GraalVM native-image

PRs welcome — open an issue first, add tests, keep terminus-core dependency-free. Open an issue →

terminus 10 / 11

~/install 11 / 11

// install

Get started.

Gradle

dependencies {
  implementation 'io.terminus:terminus-core:1.0.0'
}

Maven

<dependency>
  <groupId>io.terminus</groupId>
  <artifactId>terminus-core</artifactId>
  <version>1.0.0</version>
</dependency>

Run the demo

$ git clone https://github.com/P0intMaN/terminus.git
$ cd terminus
$ ./gradlew :terminus-demo:shadowJar
$ ./run-demo.sh   # a real terminal — not via gradle

github.com/P0intMaN/terminus

Built with Java 21 · Inspired by Bubble Tea · MIT

terminus 11 / 11

A zero-dependency TUI frameworkthat brings the component modelfrom React and Flutter to the terminal.

A complete TUI appin ~10 lines.

A live process monitor.Virtual scrolling · sortable columns · key-driven.