Install
pip install chirp-ui==0.7.0
# or
uv add chirp-ui==0.7.0
With Chirp:
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 includesdetail_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_bandfor mid-page and final calls to actionlogo_cloudfor customer, partner, integration, and ecosystem proofstory_cardfor 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
ScopedAGENTS.mdsteward 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-upandarrow-downare 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.htmlnow 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 on0.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 cimake build