Organization Navigation and Switching#

Agenta's sidebar implements a multi-tenant navigation model where the active organization and workspace are always visible at the top of the Sidebar. Users switch between organizations via a hover-triggered Ant Design Dropdown — no click required to open it.

Dropdown Switcher#

The switcher is rendered at the top of the sidebar when both selectedOrg.id and user.id are present 1. The trigger button displays:

• An avatar generated from selectedOrg.default_workspace?.name || selectedOrg.name 2
• The org/workspace name and org type as secondary text
• A CaretDown chevron icon

trigger={["hover"]} is set on the <Dropdown>, so mousing over the button opens the menu immediately 3. Clicking a non-action item calls changeSelectedOrg(key), where key is the org's ID.

Dropdown Menu Items — useDropdownItems#

The useDropdownItems hook builds the dropdown's item list. It accepts selectedOrg, orgs, user, project, projects, and logout 4.

Organization list: Only orgs whose organization_id matches a non-demo project are shown — demo projects are filtered out 5. Each org renders an avatar + name label keyed to org.id.

Fixed action items always appear at the bottom of the list 6:

The currently selected org is highlighted via selectedKeys: [selectedOrg.id] on the menu 7.

useOrgData Context#

The org context (org.context.tsx) is the source of truth for the org list and selection state. Key members:

• orgs — full list of Org[] fetched via fetchAllOrgsList() 8
• selectedOrg — the active OrgDetails | null; persisted to localStorage and restored on page load 9
• changeSelectedOrg(orgId) — fetches full org data via fetchSingleOrg, updates state, then redirects to /apps 10. This means switching orgs always resets the current route.

Collapsed / Hover Expansion#

The sidebar can be pinned collapsed (80 px) or expanded (236 px) via a toggle button, with the state persisted in localStorage as sidebarCollapsed . When collapsed, hovering over the <Sider> temporarily expands it to 236 px 12. The boolean isSidebarExpanded = collapsed && !isHovered controls child visibility throughout the component 13.

Related Files#