Navigation & Global Chrome
Every analyst page sits under a single slim top bar plus a slide-out navigation drawer. This page documents both, and each utility control on the right of the bar.
The slim top bar
A sticky bar roughly 40px tall, present on all analyst screens. It is split into a left cluster (navigation + branding) and a right cluster (utility controls).
Left cluster
| Element | What it does |
|---|---|
| Menu button (hamburger icon) | Opens the navigation drawer (see below). This is the only way to reach the page-to-page navigation links. |
| Traces logo | Links back to the analyst Dashboard (/analyst). The logo inverts automatically in dark mode. |
| "Analyst" pill | A purple badge next to the logo indicating you are in the analyst (not customer) experience. Non-interactive. |
Right cluster (utility controls)
These appear in order from left to right:
| Control | Icon | What it does |
|---|---|---|
| Theme toggle | sun/moon | Switches between light and dark theme. |
| Feature request | lightbulb | Opens a small popover for submitting a feature idea (see below). |
| Notifications | bell | Opens the notifications panel; shows an unread badge (see below). |
| Settings | gear | Opens the settings dropdown (see below). |
| Account | avatar | Clerk's user button — manage your account, switch sessions, or sign out. |
The navigation drawer
Clicking the menu button slides a 256px panel in from the left over a dimmed backdrop. Click the backdrop or the X in the drawer header to close it. Each link closes the drawer when clicked.
The drawer contains exactly these navigation items:
| Item | Destination | Notes |
|---|---|---|
| Dashboard | /analyst | Analyst home / overview. |
| Collections | /analyst/collections | Running and completed data collections. |
| Connectors | /analyst/connectors | The Connectors workspace. |
| Roadmap | /analyst/roadmap | The connector build queue / roadmap. |
| Credentials | /analyst/credentials | Stored credentials. |
| Customers | /analyst/customers | Customer records. |
The drawer header repeats the Traces logo (also links to the Dashboard).
Dashboard, Collections, Roadmap, Credentials, and Customers are operational screens documented in the operational section. This Interface Guide covers the connector-editing screens reached via Connectors.
Feature request popover
The lightbulb opens an inline popover anchored under the button:
- A short instruction line and a multi-line text area for describing the feature.
- Submit sends the request. Pressing Enter submits; Shift+Enter inserts a newline.
- On success the popover shows a confirmation ("Request submitted — thank you!") and closes after about 1.5 seconds.
- View all requests (bottom-left link) navigates to
/feature-requests. - Cancel / the X closes the popover and clears the draft.
Notifications bell
The bell opens a 380px-wide popover. The badge on the bell shows the total unread count (persisted notifications plus, on the analyst header, ephemeral session alerts); it caps the display at "9+".
The panel polls for new notifications about once a minute, so a status change made elsewhere shows up without a reload. Two kinds of items can appear:
- Alerts (analyst-only) — ephemeral session alerts grouped under an "Alerts" subheading, each colour-coded by type (error / warning / success / info) with a coloured left bar. Each alert has its own dismiss (X); Clear all dismisses the whole alert group.
- Notifications — persisted notifications. Unread ones have a blue left bar and a blue dot.
Behaviour:
- Opening the panel with unread items automatically marks notifications read.
- Mark all read appears in the header when there are unread notifications.
- When there is nothing to show, the panel displays an empty state ("No notifications yet").
Settings dropdown
The gear opens a small dropdown menu. Its contents depend on your role:
| Item | Visible to | What it does |
|---|---|---|
| Error Logs | Admins only | Links to /analyst/error-logs. |
| Replay walkthrough | All analysts | Re-runs the onboarding product tour from the beginning. Use this if you dismissed the tour and want to see it again. |
If you are not an admin and no other items apply, the dropdown shows a disabled "No settings available" placeholder.
The Replay walkthrough item is part of the onboarding-tour feature. If you do not see it yet, your deployment may not have that build; the Error Logs item (admins) is always present when applicable.