Terminal UI Design
Create distinctive, production-grade terminal user interfaces with high design quality. Use this skill when building CLI tools, TUI applications, or terminal-based interfaces. Generate creative, polished code that avoids generic terminal aesthetics.
Design Thinking
Before coding, understand the context and commit to a BOLD aesthetic direction:
- Purpose: What problem does this interface solve? Who uses it? What's the workflow?
- Tone: Pick an extreme: hacker/cyberpunk, retro-computing (80s/90s), minimalist zen, maximalist dashboard, synthwave neon, monochrome brutalist, corporate mainframe, playful/whimsical, matrix-style, steampunk terminal, vaporwave, military/tactical, art deco, paper-tape nostalgic
- Constraints: Technical requirements (Python Rich, Go bubbletea, Rust ratatui, Node.js blessed/ink, pure ANSI escape codes, ncurses)
- Differentiation: What makes this UNFORGETTABLE? What's the one thing someone will remember about this terminal experience?
Choose a clear conceptual direction and execute it with precision. A dense information dashboard and a zen single-focus interface both work—the key is intentionality, not intensity.
Box Drawing & Borders
Choose border styles that match your aesthetic:
- Single line: ┌─┐│└┘ — Clean, modern
- Double line: ╔═╗║╚╝ — Bold, formal, retro-mainframe
- Rounded: ╭─╮│╰╯ — Soft, friendly, modern
- Heavy: ┏━┓┃┗┛ — Strong, industrial
- Dashed/Dotted: ┄┆ — Light, airy, informal
- ASCII only: +-+| — Retro, universal compatibility
- Block characters: █▀▄▌▐ — Chunky, bold, brutalist
- Custom Unicode: Mix symbols like ◢◣◤◥, ●○◐◑, ▲▼◀▶ for unique frames
Avoid defaulting to simple single-line boxes. Consider asymmetric borders, double-thick headers, or decorative corners like ◆, ◈, ✦, ⬡.
Color & Theme
Commit to a cohesive palette. Terminal color strategies:
- ANSI 16: Classic, universal. Craft distinctive combinations beyond default red/green/blue
- 256-color: Rich palettes. Use color gradients, subtle background variations
- True color (24-bit): Full spectrum. Gradient text, smooth color transitions
- Monochrome: Single color with intensity variations (dim, normal, bold, reverse). Elegant constraint
Create atmosphere with:
- Background color blocks for sections
- Gradient fills using block characters ░▒▓█
- Color-coded semantic meaning (but avoid cliché red=bad, green=good)
- Inverted/reverse video for emphasis
- Dim text for secondary information, bold for primary
Palette examples (invent your own):
- Cyberpunk: Hot pink #ff00ff, electric cyan #00ffff, deep purple #1a0a2e background
- Amber terminal: #ffb000 on black, like vintage CRTs
- Nord-inspired: Cool blues and muted greens on dark blue-gray
- Hot Dog Stand: Intentionally garish yellow/red (for playful/ironic UIs)
Typography & Text Styling
The terminal is ALL typography. Make it count:
- ASCII art headers: Use figlet-style banners, custom letterforms, or Unicode art
- Text weight: Bold, dim, normal — create visual hierarchy
- Text decoration: Underline, strikethrough, italic (where supported)
- Letter spacing: Simulate with spaces for headers: H E A D E R
- Case: ALL CAPS for headers, lowercase for body, mixed for emphasis
- Unicode symbols: Enrich text with → • ◆ ★ ⚡ λ ∴ ≡ ⌘
- Custom bullets: Replace - with ▸ ◉ ✓ ⬢ › or themed symbols
ASCII Art Styles:
Block: ███████╗██╗██╗ ███████╗
Slant: /___ / / // / / ____/
Small: ╔═╗┌─┐┌─┐
Minimal: [ HEADER ]
Layout & Spatial Composition
Break free from single-column output:
- Panels & Windows: Create distinct regions with borders
- Columns: Side-by-side information using careful spacing
- Tables: Align data meaningfully, use Unicode table characters
- Whitespace: Generous padding inside panels, breathing room between sections
- Density: Match to purpose — dashboards can be dense, wizards should be sparse
- Hierarchy: Clear visual distinction between primary content, secondary info, and chrome
- Asymmetry: Off-center titles, weighted layouts, unexpected alignments
Motion & Animation
Terminals support dynamic content:
- Spinners: Beyond basic |/-. Use Braille patterns ⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏, dots ⣾⣽⣻⢿⡿⣟⣯⣷, custom sequences
- Progress bars: ▓░, █▒, [=====> ], or creative alternatives like ◐◓◑◒
- Typing effects: Reveal text character-by-character for drama
- Transitions: Wipe effects, fade in/out with color intensity
- Live updates: Streaming data, real-time charts
Data Display
- Sparklines: ▁▂▃▄▅▆▇█ for inline mini-charts
- Bar charts: Horizontal bars with block characters
- Tables: Smart column sizing, alternating row colors, aligned numbers
- Trees: ├── └── │ for hierarchies
- Status indicators: ● green, ○ empty, ◐ partial, ✓ complete, ✗ failed
- Gauges: [████████░░] with percentage
Decorative Elements
Add character without clutter:
- Dividers: ───── ═════ •••••• ░░░░░░ ≋≋≋≋≋≋
- Section markers: ▶ SECTION, [ SECTION ], ─── SECTION ───, ◆ SECTION
- Background textures: Patterns using light characters like · ∙ ░
- Icons: Nerd Font icons if available:
Anti-Patterns to Avoid
NEVER use generic terminal aesthetics like:
- Plain unformatted text output
- Default colors without intentional palette
- Basic [INFO], [ERROR] prefixes without styling
- Simple ---- dividers
- Walls of unstructured text
- Generic progress bars without personality
- Boring help text formatting
- Inconsistent spacing and alignment
Library Quick Reference
Python: Rich, Textual
Go: Bubbletea, Lipgloss
Rust: Ratatui
Node.js: Ink, Blessed
ANSI Escape Codes:
\x1b[1m Bold
\x1b[3m Italic
\x1b[4m Underline
\x1b[31m Red foreground
\x1b[38;2;R;G;Bm True color
\x1b[2J Clear screen
The terminal is a canvas with unique constraints and possibilities. Don't just print text—craft an experience.
Match implementation complexity to the aesthetic vision. A dense monitoring dashboard needs elaborate panels and live updates. A minimal CLI needs restraint, precision, and perfect alignment. Elegance comes from executing the vision well.
1---2name: terminal-ui-design3description: Create distinctive, production-grade terminal user interfaces with high design quality. Use this skill when the user asks to build CLI tools, TUI applications, or terminal-based interfaces. Generates creative, polished code that avoids generic terminal aesthetics.4metadata:5 source: https://skillmd.com/skills/duyet/terminal-ui-design6---78# Terminal UI Design910Create distinctive, production-grade terminal user interfaces with high design quality. Use this skill when building CLI tools, TUI applications, or terminal-based interfaces. Generate creative, polished code that avoids generic terminal aesthetics.1112## Design Thinking1314Before coding, understand the context and commit to a BOLD aesthetic direction:15161. **Purpose**: What problem does this interface solve? Who uses it? What's the workflow?172. **Tone**: Pick an extreme: hacker/cyberpunk, retro-computing (80s/90s), minimalist zen, maximalist dashboard, synthwave neon, monochrome brutalist, corporate mainframe, playful/whimsical, matrix-style, steampunk terminal, vaporwave, military/tactical, art deco, paper-tape nostalgic183. **Constraints**: Technical requirements (Python Rich, Go bubbletea, Rust ratatui, Node.js blessed/ink, pure ANSI escape codes, ncurses)194. **Differentiation**: What makes this UNFORGETTABLE? What's the one thing someone will remember about this terminal experience?2021Choose a clear conceptual direction and execute it with precision. A dense information dashboard and a zen single-focus interface both work—the key is intentionality, not intensity.2223## Box Drawing & Borders2425Choose border styles that match your aesthetic:2627- Single line: ┌─┐│└┘ — Clean, modern28- Double line: ╔═╗║╚╝ — Bold, formal, retro-mainframe29- Rounded: ╭─╮│╰╯ — Soft, friendly, modern30- Heavy: ┏━┓┃┗┛ — Strong, industrial31- Dashed/Dotted: ┄┆ — Light, airy, informal32- ASCII only: +-+| — Retro, universal compatibility33- Block characters: █▀▄▌▐ — Chunky, bold, brutalist34- Custom Unicode: Mix symbols like ◢◣◤◥, ●○◐◑, ▲▼◀▶ for unique frames3536Avoid defaulting to simple single-line boxes. Consider asymmetric borders, double-thick headers, or decorative corners like ◆, ◈, ✦, ⬡.3738## Color & Theme3940Commit to a cohesive palette. Terminal color strategies:4142- **ANSI 16**: Classic, universal. Craft distinctive combinations beyond default red/green/blue43- **256-color**: Rich palettes. Use color gradients, subtle background variations44- **True color (24-bit)**: Full spectrum. Gradient text, smooth color transitions45- **Monochrome**: Single color with intensity variations (dim, normal, bold, reverse). Elegant constraint4647Create atmosphere with:48- Background color blocks for sections49- Gradient fills using block characters ░▒▓█50- Color-coded semantic meaning (but avoid cliché red=bad, green=good)51- Inverted/reverse video for emphasis52- Dim text for secondary information, bold for primary5354**Palette examples** (invent your own):55- Cyberpunk: Hot pink #ff00ff, electric cyan #00ffff, deep purple #1a0a2e background56- Amber terminal: #ffb000 on black, like vintage CRTs57- Nord-inspired: Cool blues and muted greens on dark blue-gray58- Hot Dog Stand: Intentionally garish yellow/red (for playful/ironic UIs)5960## Typography & Text Styling6162The terminal is ALL typography. Make it count:63- **ASCII art headers**: Use figlet-style banners, custom letterforms, or Unicode art64- **Text weight**: Bold, dim, normal — create visual hierarchy65- **Text decoration**: Underline, strikethrough, italic (where supported)66- **Letter spacing**: Simulate with spaces for headers: H E A D E R67- **Case**: ALL CAPS for headers, lowercase for body, mixed for emphasis68- **Unicode symbols**: Enrich text with → • ◆ ★ ⚡ λ ∴ ≡ ⌘69- **Custom bullets**: Replace - with ▸ ◉ ✓ ⬢ › or themed symbols7071**ASCII Art Styles**:72```73Block: ███████╗██╗██╗ ███████╗74Slant: /___ / / // / / ____/75Small: ╔═╗┌─┐┌─┐76Minimal: [ HEADER ]77```7879## Layout & Spatial Composition8081Break free from single-column output:82- **Panels & Windows**: Create distinct regions with borders83- **Columns**: Side-by-side information using careful spacing84- **Tables**: Align data meaningfully, use Unicode table characters85- **Whitespace**: Generous padding inside panels, breathing room between sections86- **Density**: Match to purpose — dashboards can be dense, wizards should be sparse87- **Hierarchy**: Clear visual distinction between primary content, secondary info, and chrome88- **Asymmetry**: Off-center titles, weighted layouts, unexpected alignments8990## Motion & Animation9192Terminals support dynamic content:93- **Spinners**: Beyond basic |/-. Use Braille patterns ⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏, dots ⣾⣽⣻⢿⡿⣟⣯⣷, custom sequences94- **Progress bars**: ▓░, █▒, [=====> ], or creative alternatives like ◐◓◑◒95- **Typing effects**: Reveal text character-by-character for drama96- **Transitions**: Wipe effects, fade in/out with color intensity97- **Live updates**: Streaming data, real-time charts9899## Data Display100- **Sparklines**: ▁▂▃▄▅▆▇█ for inline mini-charts101- **Bar charts**: Horizontal bars with block characters102- **Tables**: Smart column sizing, alternating row colors, aligned numbers103- **Trees**: ├── └── │ for hierarchies104- **Status indicators**: ● green, ○ empty, ◐ partial, ✓ complete, ✗ failed105- **Gauges**: [████████░░] with percentage106107## Decorative Elements108109Add character without clutter:110- **Dividers**: ───── ═════ •••••• ░░░░░░ ≋≋≋≋≋≋111- **Section markers**: ▶ SECTION, [ SECTION ], ─── SECTION ───, ◆ SECTION112- **Background textures**: Patterns using light characters like · ∙ ░113- **Icons**: Nerd Font icons if available: 114115## Anti-Patterns to Avoid116117NEVER use generic terminal aesthetics like:118119- Plain unformatted text output120- Default colors without intentional palette121- Basic [INFO], [ERROR] prefixes without styling122- Simple ---- dividers123- Walls of unstructured text124- Generic progress bars without personality125- Boring help text formatting126- Inconsistent spacing and alignment127128## Library Quick Reference129130**Python**: Rich, Textual131**Go**: Bubbletea, Lipgloss132**Rust**: Ratatui133**Node.js**: Ink, Blessed134135**ANSI Escape Codes**:136```137\x1b[1m Bold138\x1b[3m Italic139\x1b[4m Underline140\x1b[31m Red foreground141\x1b[38;2;R;G;Bm True color142\x1b[2J Clear screen143```144145The terminal is a canvas with unique constraints and possibilities. Don't just print text—craft an experience.146147Match implementation complexity to the aesthetic vision. A dense monitoring dashboard needs elaborate panels and live updates. A minimal CLI needs restraint, precision, and perfect alignment. Elegance comes from executing the vision well.