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)andapp.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.