Skip to content

sasmithaK/bubbletea-TUI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Trying out Bubble Tea

"A Go framework based on The Elm Architecture. Bubble Tea is well-suited for simple and complex terminal applications."

554156183-ad408275-8799-488f-9303-441e7f869535

I've been fascinated by terminal interfaces for a while 😅. I had only used the super basic ones before, and whenever I tried building my own they were mostly hardcoded and kinda messy.

While looking for easier ways to build TUIs, I found a few frameworks made specifically for this. Textual (Python) and Bubble Tea (Go) kept popping up everywhere as top recommendations.

Since I’ve been learning Go lately, I decided to try Bubble Team, and the whole Charm ecosystem is pretty cool.


Simple demo

  1. Multi-screen Navigation: Learn how to route users between different "pages" using keyboard numbers.
  2. Progress Bar: An animated loading bar to see how background timers (ticks) work.
  3. Search & Filter Menu: A list you can filter in real-time by typing (using the TextInput component).
  4. Loading Spinner: A great way to show users that a process is running in the background without freezing the app.
  5. Help Screen: A dedicated view explaining navigation and core concepts.

image image image image


The Charm Stack

  • Bubble Tea : The core framework that runs the application loop.
  • Bubbles : Pre-built, reusable UI components like the spinner, text input, and progress bar used in this project.
  • Lipgloss : The styling engine. It acts like "CSS for your terminal," allowing us to add colors, bold text, borders, and margins.

🚀 How to Run It!

Make sure you have Go installed on your system.

  1. Clone this repository (or navigate to the folder).
  2. Install dependencies:
    go mod tidy
  3. Run the app!
    go run main.go
    

About

I've been fascinated by TUI for a while now. Found Bubble Tea, a Go framework for TUI development

Topics

Resources

Stars

Watchers

Forks

Contributors

Languages