Navigation & Layout
How to navigate the admin dashboard and understand its layout.
Navigation & Layout
Sidebar
The sidebar uses the shadcn/ui Sidebar component. Navigation items are grouped by domain:
| Group | Pages |
|---|---|
| Overview | Dashboard |
| Property Management | Properties, Reservations, Transactions |
| Users & Access | Users, System Users, Admin Roles |
| System | Tenants, Activity Log |
Collapsed mode
On desktop the sidebar can be collapsed to icon-only mode by clicking the toggle button in the top bar. Hover over any icon to see its label tooltip.
On mobile, the sidebar slides in as a drawer — tap the hamburger icon in the top bar to open it.
Top bar
The top bar contains:
- Sidebar toggle — collapses/expands the sidebar
- Breadcrumb/title — shows the current section name
Page headers
All admin index pages use the same shared page-header layout:
- Title and description identify the current dataset
- Primary action stays in the header on pages with create flows
- Search stays inline so operators can narrow the current list without leaving the page
- Filter opens a right-side sheet with page-specific controls
On desktop the header lays out as title | actions | search | filter. On mobile the actions stay on the first row and search/filter move below them. Pages with write actions collapse button labels on small screens so the header stays usable without hiding the action entirely.
Detail sheets and URL state
List pages prefer sheets over dedicated detail routes for read-only inspection.
- View details opens the right-side detail sheet for the selected row
- The selected record is reflected in the URL as
?id=<recordId> - Closing the sheet clears the
idparameter and returns focus to the current list state - Property-scoped inventory pages can also carry
?propertyId=<propertyId>in the same URL
Because the selection lives in the URL, browser back/forward navigation works as expected and specific records can be shared with other admins.
User menu
The user menu is located at the bottom-left of the sidebar. Click it to see:
- Signed-in account name and email
- Sign out action
Keyboard shortcuts
| Shortcut | Action |
|---|---|
Ctrl+B / ⌘B | Toggle sidebar |