Our take
- 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.
Stars
12,015Forks
535Change 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.
| Project | Language | License | Stars | Status |
|---|---|---|---|---|
| lipgloss | Go | MIT | 11.9k | Not checked yet |
| gum | Go | MIT | 24.5k | Active |
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/v2module path and includes a migration guide for v1 users.
Found this useful?
Share it with someone who would like lipgloss.