Getting Started

Installation

Get started with Bubble Tea, Lip Gloss, and Bubbles in your Go project.

Requirements

  • Go 1.18+ (we recommend the latest version)

Installing Bubble Tea

Bubble Tea is the core framework. Install it with:

go get github.com/charmbracelet/bubbletea/v2

Installing Lip Gloss

Lip Gloss handles styling. Add it to your project:

go get github.com/charmbracelet/lipgloss/v2

Installing Bubbles

Bubbles provides pre-built UI components:

go get github.com/charmbracelet/bubbles/v2

Complete Setup

For a typical Bubble Tea project, you'll want all three:

go get github.com/charmbracelet/bubbletea/v2
go get github.com/charmbracelet/lipgloss/v2
go get github.com/charmbracelet/bubbles/v2

Your First Import

Here's how to import the libraries in your Go code:

package main

import (
    tea "github.com/charmbracelet/bubbletea/v2"
    "github.com/charmbracelet/lipgloss/v2"
    "github.com/charmbracelet/bubbles/v2/spinner"
)
You might need to run go mod tidy to download all dependencies after adding the imports.