UI Guide

The Shell — Sidebar & Top Bar

Every page in Maestro-π shares the same frame: a narrow icon sidebar on the left, and a top bar across the full width. Only the middle content area changes as you navigate.

Home dashboard showing the sidebar and top bar

Sidebar (left) — one icon per section, always visible:

IconSectionGoes to
HomeDashboard/
DagsWorkflow list/dags
ConnectionsExternal system credentials/connections
DLQDead Letter Queue/dlq
LandingLanding Times/landing-times
AdminUser & role management/admin

The Admin entry only appears if your account has the Admin role. Connections only appears if your role grants view on connections. Everyone else just sees a shorter sidebar — this isn't a bug, it's the permission system at work.

Top bar:

  • Maestro-π logo (far left) — click it to return to the Dashboard.
  • About — product/version info.
  • Suspend — a red button that stops the underlying platform services for everyone. Only use this if you genuinely want to shut the app down; an admin has to resume it manually from the hosting platform afterward.
  • / theme toggle — switch between light and dark mode.
  • Avatar + username/role — shows who you're signed in as and which role(s) you hold.