Ratatui: Build Beautiful Terminal User Interfaces in Rust

TL;DR — Quick Summary

Ratatui is a Rust library for building rich terminal user interfaces. Widgets, layouts, styling — create beautiful TUI apps like btop, gitui, and lazygit.

Ratatui powers the TUI revolution. Build terminal apps with widgets, layouts, and style — in Rust.

Installation

# Cargo.toml
[dependencies]
ratatui = "0.28"
crossterm = "0.28"

Quick Start

use ratatui::prelude::*;
use ratatui::widgets::*;

fn ui(frame: &mut Frame) {
    let greeting = Paragraph::new("Hello Ratatui!")
        .style(Style::default().fg(Color::Green))
        .block(Block::default().borders(Borders::ALL));
    frame.render_widget(greeting, frame.area());
}

Summary

Ratatui is a Rust TUI framework
Rich widget set: tables, charts, lists, gauges
Flexible layout system with constraints
Powers popular tools like gitui, bottom
Active community fork of tui-rs

bottom System Monitor

Guide & Instructions

Estimated Time: 5m

Tools Needed:

Ratatui
Rust
Cargo

Add dependency

Add ratatui and crossterm to Cargo.toml.

Setup terminal

Initialize terminal with crossterm backend.

Create layout

Use Layout::default() with constraints.

Add widgets

Render Paragraph, List, Table widgets.

Handle input

Use crossterm events for keyboard input.

Frequently Asked Questions

What is Ratatui?

Ratatui is a Rust library (crate) for building terminal user interfaces. It provides widgets, layouts, and styling to create interactive TUI applications.

What TUI apps are built with Ratatui?

Popular apps include gitui, bottom (btm), bandwhich, spotify-tui, and many more tools covered in this library.

How is Ratatui different from tui-rs?

Ratatui is a community fork of tui-rs with active maintenance, new features, better docs, and a growing ecosystem.

What widgets does Ratatui provide?

Paragraph, List, Table, Chart, Gauge, Block, Tabs, Sparkline, BarChart, Calendar, and more.