charmbracelet

lipgloss: Style and Layout for Terminal Interfaces

Lip Gloss is a Go library for styling terminal output and composing text-based layouts. It suits developers building command-line tools and terminal user interfaces who want reusable styles, color handling, and layout helpers without implementing terminal rendering themselves.

View on GitHub Compare
Stars
11.9k
Forks
402
Stars, last 30 days
+78

Our take

Health score

53/100

How it is scored
Activity
53
Community
75
Issues
21
Pull requests
64

+78 stars in the last 30 days

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

12,015

Forks

535

Change since Nov 17, 2026: +6 stars·+21 forks

Overview

Lip Gloss is a Go library for applying styles and arranging text in terminal applications. It provides a declarative API for common formatting and layout tasks, helping developers build polished command-line output and terminal user interface views without managing low-level terminal details.

It is a companion to Bubble Tea rather than an application framework. Use it when your program needs styled text, borders, tables, lists, trees, or layered layouts. The project is maintained by Charm and distributed under the MIT license.

Key Features

  • Define reusable styles for colors, text formatting, spacing, alignment, dimensions, and borders.
  • Adapt colors to terminal capabilities, including downsampling and removing color when output is not a TTY.
  • Wrap and measure text while accounting for terminal cells and preserving ANSI styling and hyperlinks.
  • Arrange content with paragraph joining, whitespace placement, and a cell-based compositor.
  • Render tables, lists, and trees through included sub-packages.
  • Support custom border characters, list and tree enumerators, and style inheritance.

Use Cases

  • Go CLI authors can format status messages, prompts, and command output consistently.
  • Bubble Tea developers can build styled views and layouts without writing low-level rendering logic.
  • Developers producing terminal reports can render structured tables, nested lists, or trees.
  • Tool authors can generate readable output across terminals with different color capabilities, or when output is redirected.

Getting Started

Install the v2 module:

go get charm.land/lipgloss/v2

See the README for examples, advanced usage, and the v1 upgrade guide.

Alternatives

  • gum: Gum provides ready-made prompts and styled output for shell scripts, while Lip Gloss is a Go library for building custom terminal styles and layouts.
ProjectLanguageLicenseStarsStatus
lipglossGoMIT11.9kNot checked yet
gumGoMIT24.5kActive

Considerations

  • Lip Gloss is a rendering and styling library, not a terminal application framework. Pair it with Bubble Tea if you need an interactive TUI framework.
  • Color output depends on terminal capabilities. The library provides downsampling and no-color handling, but results can vary by environment.
  • The README documents v2 under the charm.land/lipgloss/v2 module path and includes a migration guide for v1 users.

Found this useful?

Share it with someone who would like lipgloss.

Comparisons