Web App Overview
The web app is a browser-based dashboard for browsing organizations, repositories, things, assertions, and action activity in WarmHub.
Access Modes
Section titled “Access Modes”Most WarmHub deployments require sign-in to reach supported app routes. Some deployments allow public browsing, where signed-out visitors can reach a subset of routes without an account. If you don’t know which mode applies to your deployment, ask your administrator or check the authentication documentation.
When public browsing is enabled, here’s what you can see at each route:
| Route | Signed out | Signed in (non-member) | Signed in (member) |
|---|---|---|---|
/organizations | Empty grid | Only your orgs | Only your orgs |
/orgs/<name> | Org info + public repos | Org info + public repos | Org info + all repos |
/orgs/<name>/repos/<repo> (public) | Full repo page | Full repo page | Full repo page |
/orgs/<name>/repos/<repo> (private) | Authentication required | Not found | Full repo page |
/orgs/<name>/flow | Sign-in prompt | Not found | Live Flow |
A few additional notes:
- Editing is permission-gated. README edits, commit creation, repo settings, and member management only appear when your role allows them. Tabs for actions you can’t perform (such as the Actions tab on a repo where you don’t have settings) are hidden, and visiting a hidden tab via URL quietly returns you to the default tab — no error panel.
- Unknown URLs still render 404. Even on private deployments, unsupported routes (including removed paths) render the Not Found page instead of the sign-in screen.
See the authentication documentation for details on signing in and managing your session.
Navigation Layout
Section titled “Navigation Layout”The interface is organized around three areas:
- Sidebar — A collapsible panel on the left with links to Home and the Organizations list. Collapse it to give the main content area more room.
- Header — Sits at the top of most pages. Contains a user menu with a theme toggle (light/dark) and a sign-out option. (Full-screen pages like Live Flow use their own toolbar instead.)
- Breadcrumb trail — Appears below the header when you are inside an organization or repository, showing your current location so you can navigate back to any parent page with one click.
Page Hierarchy
Section titled “Page Hierarchy”Pages are organized in a simple drill-down structure:
- Home — The landing dashboard with high-level statistics and quick links.
- Organizations — A grid of all organizations you belong to.
- Organizations also covers Organization Detail — repositories, members, and settings for a single organization.
- Live Flow — Real-time visualization of organization activity and data flow. Opened from the org detail page; members-only.
- Repository Detail — Things, assertions, actions, and components for a single repository, organized into tabs.
In addition to the main drill-down hierarchy, the header provides access to:
- Notifications — A bell icon in the header opens your notification feed, showing action run results and other repo-level events.
- Settings — Accessible from the user menu, this page lets you manage your account preferences.
Each level links naturally to the next, and the breadcrumb trail lets you jump back up from organization and repository pages.
Hit a problem or have a question? Get in touch.