Navigating the console

What this is

The console shell is the persistent frame that wraps every page in the MaxoPerf application. It provides the left navigation sidebar, the top bar (account switcher, workspace scope switcher, global search), and the Dashboard home page that loads when you first sign in. Understanding the shell makes every other part of the console easier to use.

Where to find it

The shell is visible on every authenticated page of the MaxoPerf console. Navigate to your console URL and sign in — the shell renders immediately.

---

Left navigation

The left navigation sidebar lists every non-admin section of the console in two groups:

Primary nav (top of sidebar):

Entry	Route	What it opens
Dashboard	/	Workspace run-activity summary and recent runs
Ideas Portal	/ideas	Feature ideas submitted to your account
Projects	/projects	Project list for the active account
Private datacenters	/private-datacenters	Outpost installation and datacenter management
Secrets	/secrets	Account-wide and workspace secrets
Tests	/tests	Expandable group: All tests + New test
Runs	/runs	All runs across the workspace

Account nav (bottom of sidebar, collapsible group):

Entry	Route	What it opens
Account → Overview	/account	Account metrics and active subscriptions
Account → Active runs	/account/active-runs	Live cross-workspace run monitor
Account → Workspaces	/workspaces	Workspace list and management
Account → Teams	/account/teams	Team definitions and membership
Account → Members	/account/members	Member list and invitation management
Billing	/billing	Usage, plans, payment method, invoices
Settings → Profile	/settings/profile	Personal profile and display name
Settings → Notifications	/settings/notifications	Email and in-app notification preferences
Settings → API keys	/settings/api-keys	Personal API key management

Console shell: left navigation sidebar with primary nav (top) and Account group (bottom).

How to use the left navigation

1. Click any top-level entry to navigate directly.
2. Click the Tests or Account group labels to expand or collapse the group.
3. The active page is highlighted with an amber left border.
4. The sidebar is always visible on desktop widths; on narrow viewports it collapses to a rail of icons.

---

Top bar

The top bar spans the full width above every page. It contains (left to right):

• Account switcher — the name of the active account with a chevron. Click to change accounts if your user belongs to more than one.
• Workspace scope switcher — a dropdown showing the currently scoped workspace (or “All workspaces”). Selecting a workspace filters the Dashboard, Runs list, and Secrets to that workspace.
• Global search — a search field that jumps to tests, runs, projects, and settings by name.

---

Account switcher

The account switcher lets you move between the accounts your user belongs to without signing out.

Console shell: account switcher dropdown open. Click the account name in the top-left to switch.

How to switch accounts

1. Click the account name in the top-left of the top bar. A dropdown opens listing every account your user is a member of.
2. Click the account you want to switch to. The console reloads scoped to the selected account.
3. The left nav and all pages update to reflect the selected account’s data.

Account vs workspace

An account maps to an organisation or team. A workspace is a subdivision of an account used to group tests and runs. See Accounts, workspaces, and projects for a full explanation.

---

Workspace scope switcher

The workspace scope switcher controls which workspace’s data appears in the Dashboard, Runs, and other workspace-scoped views.

Console shell: workspace scope switcher dropdown. Selecting a workspace scopes the Dashboard and Runs list.

How to change the workspace scope

1. Click the workspace name (or “All workspaces”) in the top bar. A dropdown opens.
2. Select a workspace to scope all workspace-filtered views to that workspace, or select All workspaces to see data across the entire account.
3. The Dashboard updates immediately — the activity chart and recent runs list reflect the selected workspace.

Secrets and workspace scope

When a workspace is selected, the Secrets nav entry navigates to that workspace’s secrets page (/workspaces/:id/secrets) instead of the account-wide secrets hub (/secrets). To reach the account-wide hub while scoped to a workspace, navigate directly to /secrets.

---

Global search

Global search lets you jump to any test, run, project, or settings page by name. Press the search shortcut or click the search field in the top bar, then type. Results appear as you type; press Enter or click a result to navigate.

---

Dashboard home

The Dashboard is the first page you see after sign-in. It is scoped to the workspace selected in the scope switcher and shows:

• Metric strip — Runs in view (first 100), pass rate, and engine count for the workspace.
• Runs started by day chart — A 14-day bar chart of run start times (UTC) derived from the sample.
• Recent runs list — Up to 8 recent runs with status badges and quick links to Metrics and Logs for each run.

Dashboard home scoped to a workspace. Top: metric strip. Middle: runs-per-day activity chart (14 days). Bottom: recent runs with quick links to Metrics and Logs.

How to use the Dashboard

1. Select a workspace using the scope switcher in the top bar. The Dashboard only loads data when a workspace is selected — without one it shows a “No workspace” empty state.
2. Read the metric strip — pass rate and run count give a quick health signal for the workspace.
3. Read the activity chart — spikes or gaps indicate when runs were being triggered.
4. Open a run — click a run name to go to the Run detail page, or use the Metrics and Logs quick-link buttons to jump straight to those tabs.
5. See all runs — click View runs in the page header to open the full Runs list with filters.

Workspace command center

The Dashboard is your workspace command center. Keep the scope switcher set to your most active workspace so the activity chart stays meaningful.

---

Tips & gotchas

• No workspace selected? The Dashboard shows an empty state. Set the workspace scope in the top bar.
• First 100 runs only. The Dashboard metric strip and activity chart are computed from the first 100 runs returned for the workspace — not the full history. For complete run history, use the Runs page.
• Account switcher vs workspace scope. Switching accounts resets the workspace scope to the default for that account. If the Dashboard looks empty after a switch, re-select your workspace.
• Secrets nav routing. When a workspace is scoped, the left-nav Secrets link goes to workspace secrets, not the account hub. Navigate to /secrets directly for the hub.
• Admin console. A collapsible “Admin console” group appears at the bottom of the sidebar for users with admin rights. Those surfaces are outside the scope of this guide.

---

Related docs

• Accounts, workspaces, and projects — explains the account → workspace → project hierarchy.
• Tests — create and configure — next stop after the Dashboard for first-time users.
• Runs — read results — how to interpret a run once it appears in the recent runs list.
• Getting started — end-to-end first-run walkthrough.
• Managed and private load locations — background on where runners execute.