# chirp-ui

> Gorgeous Chirp components — htmx-native, Kida macros, Alpine.js for interactivity

## Overview

- [chirp-ui](/chirp-ui/): Gorgeous Chirp components — htmx-native, Kida macros, Alpine.js for interactivity

## Component showcase

- [Component showcase](/chirp-ui/showcase/): Static gallery of chirp-ui macros and patterns

## Documentation

- [Documentation](/chirp-ui/docs/): Everything you need to know about chirp-ui

## Releases

- [chirp-ui 0.1.2](/chirp-ui/releases/0.1.2/): Release 0.1.2
- [chirp-ui 0.1.3](/chirp-ui/releases/0.1.3/): Release 0.1.3
- [chirp-ui 0.1.4](/chirp-ui/releases/0.1.4/): Release 0.1.4
- [chirp-ui 0.1.5](/chirp-ui/releases/0.1.5/): Release 0.1.5
- [chirp-ui 0.1.6](/chirp-ui/releases/0.1.6/): Release 0.1.6
- [chirp-ui 0.2.0](/chirp-ui/releases/0.2.0/): Release 0.2.0
- [chirp-ui 0.2.1](/chirp-ui/releases/0.2.1/): Release 0.2.1
- [chirp-ui 0.2.2](/chirp-ui/releases/0.2.2/): Release 0.2.2
- [chirp-ui 0.2.4](/chirp-ui/releases/0.2.4/): Release 0.2.4
- [chirp-ui 0.2.5](/chirp-ui/releases/0.2.5/): Release 0.2.5
- [chirp-ui 0.2.6](/chirp-ui/releases/0.2.6/): Release 0.2.6
- [chirp-ui 0.3.0](/chirp-ui/releases/0.3.0/): Release 0.3.0
- [chirp-ui 0.4.0](/chirp-ui/releases/0.4.0/): Release 0.4.0
- [chirp-ui 0.5.0](/chirp-ui/releases/0.5.0/): Release 0.5.0
- [chirp-ui 0.6.0](/chirp-ui/releases/0.6.0/): Release 0.6.0
- [chirp-ui 0.7.0](/chirp-ui/releases/0.7.0/): Release 0.7.0
- [chirp-ui 0.8.0](/chirp-ui/releases/0.8.0/): Release 0.8.0
- [chirp-ui 0.9.0](/chirp-ui/releases/0.9.0/): Release 0.9.0
- [Releases](/chirp-ui/releases/): chirp-ui release history

## About

- [About](/chirp-ui/docs/about/): Architecture, Chirp integration, and design philosophy

## App Shell

- [App Shell](/chirp-ui/docs/app-shell/): Sidebar, breadcrumbs, command palette, and layout patterns
- [UI layers & terms](/chirp-ui/docs/app-shell/ui-layers/): App shell, page chrome, surface chrome, and shell regions — one vocabulary

## Components

- [Components](/chirp-ui/docs/components/): Layout, UI, forms, streaming, and dashboard components
- [Appearance and tone](/chirp-ui/docs/components/appearance-tone/): Descriptor-backed visual preset axes for Chirp UI components
- [ASCII Primitives](/chirp-ui/docs/components/ascii/): Terminal-aesthetic UI components using Unicode box-drawing characters
- [Drawer and tray anatomy](/chirp-ui/docs/components/drawers-trays/): Rendered anatomy and behavior contracts for native drawers and store-backed trays
- [Dropdown anatomy](/chirp-ui/docs/components/dropdowns/): Rendered anatomy and Alpine contracts for dropdown menus, selects, and split menus
- [Islands & primitives](/chirp-ui/docs/components/islands/): Lightweight client-side state primitives for server-rendered UIs
- [Modal anatomy](/chirp-ui/docs/components/modals/): Rendered anatomy and behavior contracts for native modals, overlays, and confirm dialogs
- [Tabs anatomy](/chirp-ui/docs/components/tabs/): Rendered anatomy and behavior contracts for htmx tabs, tab panels, and route tabs
- [Type-aware value rendering](/chirp-ui/docs/components/type-aware-rendering/): Auto-detect Python types and apply CSS variants in description lists

## Get Started

- [Get Started](/chirp-ui/docs/get-started/): Install and configure chirp-ui
- [Installation](/chirp-ui/docs/get-started/installation/): Install chirp-ui using pip or uv

## Patterns

- [Patterns](/chirp-ui/docs/patterns/): Composition recipes for navigation, search, product, media, and community surfaces
- [Forum Patterns](/chirp-ui/docs/patterns/forums/): Community, topic list, thread, Q&A, moderation, and activity recipes
- [Layout Affinity](/chirp-ui/docs/patterns/layout-affinity/): Prototype parent-scoped layout intent attributes for Chirp UI recipes
- [Media Site Patterns](/chirp-ui/docs/patterns/media-sites/): Streaming, catalog, watch-side, live event, profile, and plan recipes
- [Navigation Patterns](/chirp-ui/docs/patterns/navigation/): Dense navigation contracts and route semantics for Chirp UI pages
- [Product Page Patterns](/chirp-ui/docs/patterns/product-pages/): Product, marketing, proof, lifecycle, story, and CTA composition recipes
- [Search Shell Patterns](/chirp-ui/docs/patterns/search-shells/): Dense catalog and reference search shell recipes for Chirp UI pages
- [Workspace Shell Recipes](/chirp-ui/docs/patterns/workspace-shells/): Dense app workspace recipes for search, operations, support, and admin surfaces.

## Theming

- [Theming](/chirp-ui/docs/theming/): CSS variables, dark mode, and customization
- [Bengal theme controls anatomy](/chirp-ui/docs/theming/bengal-theme-controls/): Packaged chirp-theme hooks for theme menus, search, mobile nav, TOC, and docs tabs
- [chirp-theme](/chirp-ui/docs/theming/chirp-theme/): Static-first Bengal theme packaged inside the chirp-ui project

## Optional

- [index.json](/chirp-ui/index.json): Search index with page metadata and excerpts
- [robots.txt](/chirp-ui/robots.txt): Content Signals directives for AI crawlers