Shell Actions

Route-scoped topbar actions for persistent app shells.

Renderer

Render the resolved action model directly inside a stable shell target.

New thread
Latest

App Shell Preview

Forum
forum / announcements / release-notes
New thread
Latest

Persistent shell, route-specific actions

Use route context to contribute actions and let Chirp refresh only the shell target during boosted navigation.

Parent routes can provide broad actions, child routes can override or clear them, and overflow actions collapse into a menu.

Topbar Variants

topbar_variant="default|glass|gradient" — style the topbar independently.

Glass topbar

Frosted-glass topbar with backdrop blur.

Gradient topbar

Gradient topbar background.

Sidebar Variants

sidebar_variant="default|glass|muted" — style the sidebar independently.

Glass sidebar

Glass sidebar with backdrop blur.

Muted sidebar

Muted sidebar background.

Pattern Notes

  • Use a stable shell target like chirp-shell-actions inside app_shell.
  • Let route _context.py files contribute ShellActions instead of hand-authoring topbar HTML per page.
  • Boosted navigation updates the main content and refreshes the shell target with an OOB fragment when actions change.