Examples

Practical examples for common TUI use cases. All code is runnable and assumes you have imported tui and tui/widget.

Quick Navigation

Hello World

Minimal Application The simplest TUI application renders text and quits on Ctrl+C: go Copy package main import ( …

Layout

Vertical Split Split an area into rows with constraints: go Copy func (a *app) Render(buf *tui.Buffer, area tui.Rect) { …

Styling

Colors TUI supports three color spaces: go Copy // ANSI 16 standard colors tui.Red tui.BrightBlue // 256-color palette …

Widgets

Text Static text display with alignment: go Copy t := widget.NewText("Hello, World!") …

Images

Display from image.Image The simplest way to show an image: go Copy imgWidget := widget.NewImage(myImage) …

Animation

Basic Animation Flow Transmit the base image (frame 1) Add animation frames with NewAnimation Encode and send all frames …

Styled Text

Spans A Span is a run of text with a uniform style: go Copy span := tui.NewSpan("important", …

Focus and Input

Focus Manager Track focus across named components: go Copy focus := tui.NewFocusManager("sidebar", …

Timers

Periodic Tick Send a message at regular intervals: go Copy func (a *app) Init() tui.Cmd { return tui.TickCmd(100 * …

Demo Application

Running the Demos The examples/ directory contains runnable demo applications: bash Copy # Simple list and input go run …