# chirp-ui 0.2.5

URL: /chirp-ui/releases/0.2.5/
Section: releases
Description: Release 0.2.5

---

> For a complete page index, fetch /chirp-ui/llms.txt.

## Install

```bash
pip install chirp-ui==0.2.5
# or
uv add chirp-ui==0.2.5
```

With Chirp:

```bash
pip install "bengal-chirp[ui]"
```

## What's New

- **O(1) color lookup** — `resolve_color` uses a dict instead of linear scan; `icon` filter caches the sorted icon list after first call.
- **Shell tabs contract** — New `docs/SHELL-TABS-CONTRACT.md` documenting shell-region tab ownership rules. `route_tabs` now accepts dict-shape `tab_items` in addition to the existing list shape.
- **Alpine.js troubleshooting guide** — Diagnosis steps for when all interactive components stop working (missing Alpine script, bad CDN URL, stale installs).

## Links

- [PyPI](https://pypi.org/project/chirp-ui/)
- [GitHub](https://github.com/lbliii/chirp-ui)