v0.3.0

Scrolling, autocomplete, smaller binaries and more!

This is a big release with a tonne of new features.

• Scrollable Forms
• Scrollable Selects and Multi selects
• Autocomplete for inputs
• 7x smaller binaries
• Multi select filtering
• Lotsa' bugfixes and quality-of-life improvements

To upgrade to huh v0.3.0:

go get -u github.com/charmbracelet/huh@latest

For details read on!

Scrollable forms

If a form is in a small terminal it will automatically resize to fit the available space and the active group will scroll to stay in view. Form heights can also be set manually with the new WithHeight method.

Select and Multi select Scrolling

Select and Multi select fields can now be restricted to a certain height, allowing their options to be scrollable. This means you can now pack in tonnes of options.

To make a Select or MultiSelect scrollable simply set the height on the field or form through the Height method.

s := huh.NewSelect()
    .Title("What’s for dinner?")
    .Options(/* ... */)
    .Height(height)

Autocomplete

Now Inputs can offer suggestions making it easier for users to fill out inputs. These suggestions can be accepted autocomplete-style with a configurable key binding (which defaults to ctrl+e).

Simply provide a []string to Suggestions to enable this feature.

huh.NewInput().
    Title("What's for lunch?").
    Prompt("? ").
    Suggestions([]string{
        "Artichoke",
        // ...
        "Cashew Apple",
        "Cashews",
        "Cat Food",
        "Coconut Milk",
        "Cucumber",
        "Curry Paste",
        "Currywurst",
        // ...
    })

More helpful help

Forms will automatically adjust their help text to indicate to the user whether the form will continue or submit on actions. This works with hidden groups. In the below example, the user will be asked to list their allergies if they select "Yes" otherwise, the form will submit.

Way smaller binaries

Huh now produces way smaller binaries! Thanks to #94 Huh now has a 7x smaller compiled footprint.

Before, using huh@v0.2.3:

33M     ./burger

After, using huh@v0.3.0:

4.5M    ./burger

Thanks, Vitor!

Special thanks to the intrepid @vitor-mariano, one of the earliest huh contributors, who came in hot with features, fixes, improvements and good vibes. Thank you, Vitor!

Changelog

New

• scrollable multi-select by @meowgorithm in #71
• scrollable select by @meowgorithm in #76
• feat: enable filtering on MultiSelect by @vitor-mariano in #81
• skippable Fields by @maaslalani in #116
• autocomplete suggestions on inputs by @maaslalani in #93
• scroll form Inputs by @maaslalani in #95
• next / previous dynamic help by @maaslalani in #104
• reduce binary size by @maaslalani in #94

Fixed

• fix Select and MultiSelect height when unfocused by @vitor-mariano in #80
• use CharLimit in textinput by @maaslalani in #79
• select viewport on filtering by @vitor-mariano in #84
• set default theme on inputs by @maaslalani in #92
• multiselect: set height in WithHeight by @ardnew in #118
• shift+tab would fail if first group is hidden by @caarlos0 in #103
• prevField should not select skippable fields by @maaslalani in #121

Full Changelog: v0.2.3...v0.3.0

---

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.