https://github.com/shawalli/bubbles

TUI components for Bubble Tea 🫧
https://github.com/shawalli/bubbles

bubbles bubbletea cli go golang terminal tui

Last synced: 8 months ago
JSON representation

TUI components for Bubble Tea 🫧

• Host: GitHub
• URL: https://github.com/shawalli/bubbles
• Owner: shawalli
• License: mit
• Created: 2024-09-06T20:46:53.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2025-03-03T10:51:51.000Z (over 1 year ago)
• Last Synced: 2025-03-30T08:41:30.342Z (about 1 year ago)
• Topics: bubbles, bubbletea, cli, go, golang, terminal, tui
• Language: Go
• Homepage:
• Size: 553 KB
• Stars: 4
• Watchers: 1
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# bubbles

[![Go Reference](https://pkg.go.dev/badge/github.com/shawalli/bubbles.svg)](https://pkg.go.dev/github.com/shawalli/bubbles)

bubbles is a collection of TUI elements for [Bubble Tea](https://github.com/charmbracelet/bubbletea) applications.

## Calendar

![Calendar monthly journal demo](assets/calendar-month-journal.gif)

![Calendar monthly shift schedule demo](assets/calendar-month-shift-schedule.gif)

![Calendar weekly schedule demo](assets/calendar-week-schedule.gif)

`calendar` enables the rendering and management of monthly and weekly calendars.

While defaults are configured for the US, things such as the start of the week, days of the week,

and more are configurable.

* [Example code, monthly journal](examples/calendar/month-journal/main.go)

* [Example code, monthly shift schedule](examples/calendar/month-shift-schedule/main.go)

* [Example code, weekly schedule](examples/calendar/week-schedule/main.go)

## Radio

![Simple radio button demo](assets/radio-simple.gif)

![Grouped radio button demo](assets/radio-grouped.gif)

`radio` simplifies the management of radio buttons, which may be presented vertically or horizontally.

* [Example code, basic radio buttons](examples/radio/simple/main.go)

* [Example code, pill-style buttons](examples/radio/pill/main.go)

* [Example code, grouped buttons](examples/radio/resizeable/main.go)

## Tabs

![Wraparound tab demo](assets/tabs-wraparound.gif)

`tabs` is a remix on the [Bubble Tea tabs example](https://github.com/charmbracelet/bubbletea/tree/main/examples/tabs).

It abstracts away the tab logic into a separate model and provides management of tab-content.

* [Example code, basic tabs](examples/tabs/simple/main.go)

* [Example code, wraparound tabs](examples/tabs/wraparound/main.go)

* [Example code, resizeable tabs](examples/tabs/resizeable/main.go)

## License

This project is licensed under the terms of the MIT license.