Przejdź do treści
Biblioteka skilli
Programowanie · Research

tui-component-browser

/tui-component-browser

Przegląda biblioteki komponentów Charm przed napisaniem nowej funkcji TUI, by znaleźć gotowe elementy do ekranów Bubble Tea.

Repozytorium
mazarbul ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
31.10.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
4
Przestarzałość

Brak sygnałów. Repozytorium zmienione 31.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Przegląda biblioteki komponentów Charm przed napisaniem nowej funkcji TUI, by znaleźć gotowe elementy do ekranów Bubble Tea.

Oryginalny opis (EN)

Before writing a new TUI feature, browse the Charm component libraries for existing components. USE WHEN starting a new Bubble Tea screen, picking between custom and existing components, or unsure which component fits. Uses WebFetch to grab the source of relevant components from charmbracelet/bubbles and charmbracelet/huh.

Jak działa

  1. Workflow
  2. Need -> component map
  3. When to roll your own
  4. Reading the source
  5. Gotchas
Sekcje z nagłówków SKILL.md, w oryginale · 66 linii, 569 słów
Podgląd SKILL.md
---
name: tui-component-browser
description: Before writing a new TUI feature, browse the Charm component libraries for existing components. USE WHEN starting a new Bubble Tea screen, picking between custom and existing components, or unsure which component fits. Uses WebFetch to grab the source of relevant components from charmbracelet/bubbles and charmbracelet/huh.
allowed-tools: Read, Glob, Grep, WebFetch
---

# TUI Component Browser

Before writing a custom Bubble Tea component, check the Charm libraries. Reinventing burns time and ships inconsistent UX.

## Workflow

1. **Identify the need.** What does the user need to do? (Pick, type, scroll, watch progress, see a list, edit a long string, confirm.)

2. **Browse the catalog.** Fetch the index of each library:
   - `WebFetch https://github.com/charmbracelet/bubbles` -> see the README's component list.
   - `WebFetch https://github.com/charmbracelet/huh` -> see the README's form primitives.

3. **Match the need to a component.** Use the table below as a starting point.

4. **Read the component source.** If a candidate exists, fetch its source to confirm the API fits:
   - `WebFetch https://github.com/charmbracelet/bubbles/blob/master/<component>/<component>.go`
   - `WebFetch https://github.com/charmbracelet/huh/blob/main/<primitive>.go`

5. **Decide.** Use the existing component unless it provably doesn't fit. "It would feel slightly different" is not a reason to roll your own.

## Need -> component map

| Need | Library | Component | Notes |
|---|---|---|---|
| Pick from a list (single) | huh | `huh.NewSelect[T]` | Form primitive, embed in form or use standalone. |
| Pick from a list (multi) | huh | `huh.NewMultiSelect[T]` | Same as above. |
| Free text input | huh | `huh.NewInput` | Validation, masking, placeholder support. |
| Confirm yes/no | huh | `huh.NewConfirm` | Default focus on the safe option. |
| Note / instruction | huh | `huh.NewNote` | Markdown-style content step. |
| Loading spinner | bubbles | `spinner.New(spinner.Moon)` | Moon for thinking, Dot for short waits. |
| Measurable progress | bubbles | `progress.New()` | Animate via `progress.IncrPercent`. |
| Scrollable view | bubbles | `viewport.New(w, h)` | Set content via `viewport.SetContent`. |
| Selectable list | bubbles | `list.New(items, delegate, w, h)` | Built-in filter and pagination. |
| Tabular data | bubbles | `table.New(...)` | Sortable columns, keyboard navigation. |
| Pagination control | bubbles | `paginator.New()` | Dots-style page indicator. |
| Single-line text input | bubbles | `textinput.New()` | Lower-level than `huh.NewInput`. |
| Multi-line text input | bubbles | `textarea.New()` | For longer-form editing. |
| File picker | huh | `huh.NewFilePicker` | Browse + pick a path. |
| Key bindings | bubbles | `key.NewBinding` | Centralizes help text and binding. |
| Help panel | bubbles | `help.New()` | Renders key bindings as a help row. |

## When to roll your own

Custom components are justified when:
- The interaction model doesn't exist in either library (rare).
- The visual treatment requires a layout primitive not in lipgloss.
- The component is genuinely Mazarbul-specific (e.g. the Watchword block, the entity provenance trail).

If you're rolling your own:
- Live under `internal/tui/<screen>/components/` if scoped to one screen.
- Live under `internal/tui/components/` if shared across screens.
- Follow the same `Init/Update/View` pattern as bubbles.
- Add a snapshot test.

## Reading the source

Charm code is small and readable. When in doubt, read the component's `view.go` and `update.go`. The conventions you'll pick up apply across the whole stack.

## Gotchas

- **Different `Update` signatures.** Some components return `tea.Cmd`, some return `(Model, tea.Cmd)`. Read before integrating.
- **Theme integration.** Some components accept a styles struct (e.g. `list.DefaultStyles()`). Override via `internal/tui/style.Theme` accessors, not raw hex.
- **Key binding conflicts.** Embedded components may bind keys that the host model also wants. Use `key.Binding.SetEnabled(false)` to suppress when the host has focus.
- **Help text consistency.** Use `bubbles/help.Model` with `key.NewBinding(key.WithHelp(...))` so every screen's help row reads the same way.

Wersje

W bazie nie ma innych skilli o nazwie tui-component-browser.

Migawka bazy z 13.11.2026 · wersja paczki da3f3add53d1 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100go-tui
    Buduje, recenzuje i debuguje terminalowe interfejsy w Go ze stosem Charm (Bubble Tea, Lip Gloss, Bubbles, ntcharts), w tym dashboardy i pełnoekranowe CLI.
  • 100cli-tui
    Buduje i zmienia TUI Bubble Tea w CLI hive pod cmd/hive/internal/tui: widoki, modale, skróty klawiszowe i asynchroniczne ładowanie, z testami komponentów i plikami golden.
  • 100charm-bracelet-tui
    Prowadzi przez budowę interaktywnych aplikacji TUI w Go z ekosystemem Charm Bracelet: bubbletea, bubbles, lipgloss, glamour, huh i pokrewne biblioteki.
  • 100building-glamorous-tuis
    Buduje interfejsy terminalowe z Charmbracelet (Bubble Tea, Lip Gloss, Gum): TUI w Go, prompty i spinnery w powłoce, układy adaptacyjne, renderowanie asynchroniczne, maszyny stanów fokusu, sparkline'y, heatmapy, tablice kanban i aplikacje SSH.
  • 100review-tui
    Prowadzi pełny code review aplikacji terminalowych BubbleTea: charmbracelet/bubbletea, lipgloss, bubbles i Wish SSH, opcjonalnie współbieżnie dla każdego obszaru.
  • 86add-screen
    Dodaje ekran do interfejsu Bubble Tea z klawiszami, pomocą, wzorcowym zrzutem klatki i testami.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.