This is a comprehensive reference for building terminal UIs with ratatui, Rust's modern TUI library. It covers the full stack: four project templates ranging from a 25-line hello world to a 300-line async component app, the Elm Architecture pattern (Model/Message/Update/View), styling with the Stylize trait, StatefulWidget implementations, and async event handling with crossterm's EventStream. The image integration section is unusually thorough, explaining how to use ratatui-image with background threads and protocol caching. Most useful when you're starting a new TUI project and need working patterns for layout, keyboard navigation, or error handling with color-eyre. The templates alone save hours of boilerplate setup. Targets ratatui 0.30.0 and Rust edition 2024.

skills.sh installs
871
GitHub stars
17
last updated
Aug 21, 2026

Install

$ npx -y skills add blacktop/dotfiles --skill ratatui-tui --agent claude-code

Installs into .claude/skills of the current project.

Files

Ratatui TUI Development

Quick Start

  1. Copy template to project:

    cp -r ~/.agents/skills/ratatui-tui/assets/templates/<template>/* .
    

    Or generate from the official templates repo:

    cargo install --locked cargo-generate
    cargo generate ratatui/templates
    
  2. Run:

    cargo run
    

Version Notes (0.30.x)

Targets 0.30.x (MSRV 1.88, edition 2024); run cargo info ratatui for the current patch release.

Sponsors

Details

Repository
github.com/blacktop/dotfiles
Categories
Backend & APIs, DevOps & CI/CD, Code Review & Quality, Release Management, Rust, Design & UI/UX, CLI & Terminal
First seen
Jun 3, 2026
1nathan-gage avatarpython-best-practicesnathan-gage/python-skillsPython software engineering guidelines from real PR review patterns. This skill should be used when writing, reviewing, or refactoring Python code — especially 868skills.sh installs
2oracle avatarnetsuite-suitescript-upgradeoracle/netsuite-suitecloud-sdkSuiteScript 1.0, 2.0, and 2.x to 2.1 migration assistant. Analyzes, converts, explains, and validates script upgrades. Covers 125+ API mappings, 34 object conve867skills.sh installs
3alirezarezvani avatarsecurity-pen-testingalirezarezvani/claude-skillsUse when the user asks to perform security audits, penetration testing, vulnerability scanning, OWASP Top 10 checks, or offensive security assessments. Covers s862skills.sh installs
4mindrally avatarnuxtjs-vue-typescriptmindrally/skillsNuxtJS and Vue 3 development with TypeScript, Composition API, Shadcn Vue, and Tailwind CSS for modern web applications.862skills.sh installs
5hairyf avatarnexthairyf/skillsNext.js framework for building React applications with App Router, Server Components, and optimized performance. Use when working with Next.js apps, routing, da860skills.sh installs
6pproenca avatartanstack-querypproenca/dot-skillsTanStack Query v5 performance optimization for data fetching, caching, mutations, and query patterns. This skill should be used when using useQuery, useMutation858skills.sh installs