Repolode
Enviar
charmbracelet

charmbracelet/bubbletea

Un framework de Go para crear interfaces de usuario de terminal con el patrón modelo-actualización-vista de The Elm Architecture.

Ver en GitHub
Estrellas
45,471
Forks
4,035
Issues abiertos
272
Último commit
hace 13 días

¿Qué es?

Bubble Tea es un framework de Go para crear aplicaciones de terminal, desde pequeñas herramientas interactivas hasta programas más grandes a pantalla completa. Sigue The Elm Architecture: una aplicación es un modelo que mantiene el estado, una función Update que procesa mensajes como las pulsaciones de teclas y una función View que representa la interfaz a partir de ese estado. El runtime se encarga de volver a dibujar la interfaz, así que los desarrolladores describen la UI en lugar de gestionar manualmente la salida del terminal.

El framework admite diseños en línea, a pantalla completa y mixtos. Incluye un renderizador basado en celdas, reducción de la profundidad de color para terminales con paletas limitadas, vistas declarativas que permiten configurar opciones como el modo de pantalla alternativa y el seguimiento del mouse, gestión de la entrada del teclado y del mouse, y compatibilidad con el portapapeles. Los comandos permiten que los programas realicen operaciones de E/S, como temporizadores o solicitudes de red, sin bloquear la interfaz.

Bubble Tea suele combinarse con otras bibliotecas del mismo proyecto: Bubbles, que ofrece componentes listos para usar, como campos de texto y viewports; Lip Gloss, para estilos y diseño; y Harmonica, para animaciones.

Funciones clave

  • 01Implementa The Elm Architecture con los métodos Init, Update y View en un modelo.
  • 02Incluye un renderizador basado en celdas y reducción de la profundidad de color integrada.
  • 03Admite diseños de terminal en línea, a pantalla completa y mixtos.
  • 04Gestiona la entrada del teclado y del mouse, además del acceso nativo al portapapeles.
  • 05Ofrece un sistema de comandos para operaciones de E/S asíncronas, como temporizadores y solicitudes.

Casos de uso

  • Crear herramientas interactivas de línea de comandos en Go con formularios, listas o menús.
  • Crear paneles de terminal o administradores de archivos a pantalla completa.
  • Desarrollar juegos o visualizaciones de terminal que respondan a eventos de entrada.

Inicio rápido

  1. 1

    Importa el paquete Bubble Tea v2 en tu código Go

  2. 2

    Descarga bubbletea y sus dependencias

    go mod tidy

Antes de usarlo

  • Está escrito en Go, así que necesitas conocimientos prácticos de Go para usarlo.
  • Para actualizar desde la v1, debes seguir una guía de actualización específica, ya que la v2 cambia la API.

Temas

#tui#go#golang#cli#elm-architecture#terminal-ui#framework#functional#hacktoberfest

Preguntas frecuentes

¿Qué es bubbletea?
Un framework de Go para crear interfaces de usuario de terminal con el patrón modelo-actualización-vista de The Elm Architecture. Bubble Tea es un framework de Go para crear aplicaciones de terminal, desde pequeñas herramientas interactivas hasta programas más grandes a pantalla completa. Sigue The Elm Architecture: una aplicación es un modelo que mantiene el estado, una función Update que procesa mensajes como las pulsaciones de teclas y una función View que representa la interfaz a partir de ese estado. El runtime se encarga de volver a dibujar la interfaz, así que los desarrolladores describen la UI en lugar de gestionar manualmente la salida del terminal.
¿bubbletea es gratuito? ¿Qué licencia tiene?
bubbletea es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿bubbletea sigue mantenido?
Mantenimiento activo. El último commit de bubbletea fue el 8 oct 2026.
¿Para qué puedo usar bubbletea?
Crear herramientas interactivas de línea de comandos en Go con formularios, listas o menús. Crear paneles de terminal o administradores de archivos a pantalla completa. Desarrollar juegos o visualizaciones de terminal que respondan a eventos de entrada.
¿Cómo se instala bubbletea?
Importa el paquete Bubble Tea v2 en tu código Go Descarga bubbletea y sus dependencias: go mod tidy
¿Dónde consigo bubbletea?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/charmbracelet/bubbletea

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados