v0.10.0

charmbracelet/gumv0.10.0Mar 27, 2023by github-actions[bot]

AI Summary

This version brings major improvements including full truecolor support, official Windows compatibility, and context headers for selection commands. It also adds ordered selection and improved page navigation for file selection.

Key Highlights

Truecolor support (replaces ANSI256)
Official Windows support for PowerShell
Context headers (`--header`) for `choose` and `filter`
Keep order of selected items with `--ordered` flag
Page up/down key bindings in `gum file`

New Features

truecolor support
windows support
--header flags
--ordered flag
page navigation
programming language support for gum format

Full Release Notes

## Truecolor Support

Gum historically was limited to ANSI256 colors, but no longer is this the case!

With `v0.10.0`, `gum` can now display truecolor if your terminal emulator supports it! 🎨 

Try it out with `gum style`:

```
gum style --padding "3 10" --margin 2 --background "#6a51ff" --foreground "#ff6dff" "The best colors are true"
```

<img width="467" alt="image" src="https://user-images.githubusercontent.com/42545625/228007197-6cdf3048-8bf5-467e-905e-3dfdf218e9a0.png">

## Windows Support

Windows users rejoice! Gum `v0.10.0` solves a variety of issues allowing `gum` to work on Powershell and Windows. 🪟 

Don't believe us? Take a look for yourself:

![windows](https://user-images.githubusercontent.com/42545625/228008447-cc52a570-0b2d-4ad2-9836-4d283999a075.png)

## Context Headers

With Gum `v0.10.0`, you can add context with `--header` flags in `gum choose` and `gum filter`. To get started:

```bash
gum choose --header "Pick your starter Pokémon" "Bulbasaur" "Charmander" "Squirtle"
```

<img width="800" src="https://vhs.charm.sh/vhs-3g2AVZfFfAE6A0Yky8Fb4v.gif" alt="Made with VHS">

### New Features
* Keep order of selected items in `gum choose` with the `--ordered` flag.
* Use page up / down key bindings in `gum file`
* `gum choose` and `gum filter` can select using <kbd>ctrl+space</kbd>
* `--header` flags for `gum choose` and `gum filter`
* Pass programming language for `gum format --type code`
 
* * *

<a href="https://charm.sh/"><img alt="The Charm logo" src="https://stuff.charm.sh/charm-badge.jpg" width="400"></a>

Thoughts? Questions? We love hearing from you. Feel free to reach out on [Twitter](https://twitter.com/charmcli), [The Fediverse](https://mastodon.technology/@charm), or on [Discord](https://charm.sh/chat).