# chirp-ui 0.7.0

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

---

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

## Install

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

With Chirp:

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

## What's New

### Navigation contracts and dense app recipes

This release promotes navigation from one-off example styling into a clearer
composition contract. The docs now describe when to use global navigation,
object/workspace tabs, breadcrumbs, command bars, saved views, and local
scope-switching patterns.

The component showcase also gains dense navigation recipes for several common
product shapes:

- Business object consoles
- Cloud and control-plane applications
- Collaboration inboxes
- Developer platforms
- Editor workbenches
- Knowledge workspaces
- Observability and ops consoles
- Product-suite work hubs
- Reference documentation
- Keyboard-first trackers

### Official pattern assets

New experimental pattern assets cover marketing, media, forum/social, and
detail surfaces. The first public set includes `detail_header`, `facet_chip`,
`thread_reader_layout`, `topic_card`, `answer_card`,
`moderation_queue_item`, and media catalog/watch patterns.

Marketing pages also get focused proof and conversion primitives:

- `cta_band` for mid-page and final calls to action
- `logo_cloud` for customer, partner, integration, and ecosystem proof
- `story_card` for customer outcome and use-case proof grids

### Product and forum pattern coverage

Product-page recipes now cover hero/proof sections, lifecycle showcases, proof
bands, product choice grids, customer story strips, and CTA bands. A browser
fixture exercises those recipes across responsive widths.

Forum and community patterns now have a browser-tested fixture covering dense
community pages, thread views, Q&A, moderation, and activity compositions. The
fixture is intentionally paired with a promotion checkpoint: existing ChirpUI
vocabulary should be tried first, and public forum-specific macros need
stronger migration evidence before promotion.

### Steward system

Scoped `AGENTS.md` steward guidance now documents ownership for registry,
rendering, theme, build, CI/release, tests, docs, planning, examples, and the
published site. The root steward protocol also now includes swarm guidance,
contract checklists, and release stewardship expectations.

## Changed

- Action bar items now resolve semantic icon names through the ChirpUI icon
  registry, including forum/social actions like reply, vote, watch, follow,
  report, and share.
- `arrow-up` and `arrow-down` are registered icon aliases for vote recipes.
- Action-bar and post-card API examples now teach semantic icon names instead
  of raw glyphs.
- Component showcase contracts now require generated CSS, manifest-backed
  templates, and warning-free current component APIs.

## Fixed

- `app_layout.html` now uses Chirp's current injected Alpine runtime, loads the
  data-theme-aware starter theme, and avoids duplicate or stale Alpine scripts
  in showcase-style apps.
- Docs-site release pages and the GitHub Pages workflow now render under Bengal
  0.3.2's current CLI and tolerate optional theme metadata/menu fields.
- Dropdown select events now preserve option values.
- Split button menus now have harder positioning and fused visual styling.
- Shell-frame boosted navigation scroll restoration, hash-anchor landing, and
  split panel Alpine drag state fixes from the 0.6.0 release gate are carried
  into this release.

## Upgrade Notes

This should be a low-disruption upgrade for apps already on `0.6.x`.

- If you have custom app navigation, compare it against the new navigation
  contract docs before adding new component vocabulary.
- If you use action bars or forum/social actions, prefer semantic icon names
  over raw glyph labels.
- If you maintain showcase-style apps, remove any stale duplicate Alpine script
  wiring and let Chirp inject its current runtime.

## Verification

Release prep passed:

- `uv run poe ci`
- `make build`

## Links

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