# Contacts Shell

URL: /chirp/docs/examples/contacts-shell/
Section: examples
Tags: examples, chirp-ui, app-shell, pages

--------------------------------------------------------------------------------

What It Teaches This example is the app-shell version of the plain contacts app. Use it when you are moving from isolated htmx fragments to a persistent shell with mounted pages and shell-aware swaps. It demonstrates: use_chirp_ui(app) and app.mount_pages() chirpui/app_shell_layout.html route-scoped shell actions query-backed search state inline row editing without stale filtered results typed repeated-field parsing with form_from() Run It PYTHONPATH=src python examples/chirpui/contacts_shell/app.py Test It pytest examples/chirpui/contacts_shell/ Contract Surface The example is useful for app-shell contract work: route metadata, mounted pages, shell actions, boosted navigation, and fragment scopes all need to agree. Use it when changing pages, shells, route contracts, or ChirpUI-facing docs. Source app.py README.md Next App Shells Route Directory chirp-ui

--------------------------------------------------------------------------------

Metadata:
- Word Count: 112
- Reading Time: 1 minutes