Default layout
The dashboard sidebar always keeps Dashboard in the root navigation. By default, the root navigation then shows Tasks, Calendar, and Finance. All other eligible top-level tools are placed under More tools. More tools is grouped into durable sections:- Work tools: Habits, Whiteboards, Track, Drive, Forms, Documents
- AI: Mind, Hive, Chat, AI Lab
- Operations: Workforce, Users, Inventory
- Utilities: QR Generator, Google Workspace, Meet, Polls, Mail, Education, Link Shortener
Managing layout
Users manage start-page navigation, sidebar behavior, sidebar layout, and recent-history visibility from Settings → Preferences → Navigation & Sidebar. On desktop, Expand on hover keeps the sidebar open while a popover, menu, or dialog opened from it is active. After you dismiss the last overlay, the sidebar collapses if the pointer is outside it. This applies to Web, Workspace, and satellite dashboards that offer hover expansion. The collapsed rail, and the resting rail of Expand on hover, show icons only by default (decided 2026-11-22). Each item’s tooltip and accessible name carry its full name. Settings → Sidebar → Show navigation labels (off by default) brings back a one-line caption under each icon, Settings included; long names truncate. The choice is saved to the account (user configSIDEBAR_NAV_LABELS), so every app’s sidebar follows it, and each device
applies its last value before the first paint (data-nav-labels="shown" on
<html>), so the rail never flips after loading. The rail stays 4rem wide either
way. This applies to Web, Workspace, and satellite dashboards that render items
through the shared NavLink; Colab draws its own rail items and stays icon-only.
Meet exposes the same preference and sidebar modes under Settings → Sidebar.
In the sidebar footer, Feedback is a compact icon button on the same row as
Settings, with a tooltip and an accessible name; Discord, when configured,
sits beside it the same way, and Upgrade, when offered, keeps its label in
the expanded sidebar. In the collapsed rail they stack under Settings as icon
buttons. The account and notification controls are unchanged. Coverage:
packages/ui/src/components/ui/custom/nav-link.test.tsx,
packages/satellite/src/components/sidebar-settings-button.test.tsx,
structure.test.tsx and satellite-shell.test.tsx (footer row),
experimental-ui-sync.test.tsx and sorbet-pre-paint.test.tsx (the label
choice), and the layout-shift harness in
Web design system.
Sidebar modes
Settings → Sidebar → Sidebar Behavior offers four modes on desktop. The choice follows the account across browsers unless Local Override is on.
Minimal (decided 2026-11-22) is the mode for the most room: the rail, its
border and the account controls are gone and only the logo floats at the top
left. A fixed 3.5rem gutter keeps page content clear of the logo while the panel
opens and closes.
- Hover: resting the pointer on the logo or anywhere along the left edge for 120 ms opens the sidebar as a floating panel over the page. A pointer that only crosses the edge opens nothing. Leaving closes it after 240 ms, so slipping off and back keeps it open.
- Keyboard: focusing the logo opens the panel and leaves focus on the logo; the panel draws the focus ring meanwhile. Tab moves through the panel and loops inside it. Escape closes it and returns focus to the logo; Enter or Space on the logo toggles it. Picking a destination closes the panel.
- Touch: a tap on the logo opens the panel; a tap outside, or on a destination, closes it.
- Overlays: a menu, dialog or popover opened from the panel keeps it open and takes the first Escape.
- Motion: the panel fades and slides in over 180 ms, and appears at once when reduced motion is preferred.
- Phones: the top bar and drawer are the same as in every other mode.
hidden value reads as minimal everywhere
(the behavior cookie, the account preference and the assistant’s set_sidebar
tool). The cookie is rewritten on the next visit. Selecting a mode saves its
current value to the account. Cmd/Ctrl+Alt+B switches to Minimal and
Cmd/Ctrl+B switches from it to Collapsed. The tasks board’s Minimal sidebar
action and the account menu use the same mode.
In satellite Settings, the sidebar keeps its current layout until the dialog
closes. Focus returns to the control that opened Settings or to the reveal logo
if the selected mode replaced that control.
Scope: Web, Workspace, Colab and every satellite sidebar. Exception: Nova has a
single fixed sidebar and no modes. Coverage: sidebar-behavior.test.ts,
structure-minimal.test.tsx, and the cookie and account-preference cases in
sidebar-context.test.tsx and sidebar-remote-behavior-bridge.test.tsx under
packages/ui/src/components/ui/custom/.
Workspace switcher
When Show workspace selector is on, the sidebar shows a compact Switch workspace row with the current workspace’s avatar, under the app name (decided 2026-11-22). It replaces the earlier dropdown-style control that showed the workspace name, plan badge and a chevron: workspaces are chosen in the Select workspace dialog, so nothing in the sidebar reads as a dropdown. Clicking the row, or pressing Cmd+Shift+K (Ctrl+Shift+K), opens that dialog; the dialog and shortcut are unchanged. A pending-invitation count still shows beside the label and is announced as the row’s description. This applies to Web, Workspace and every satellite sidebar. On desktop, collapsing the sidebar keeps the selector visible as an avatar with a tooltip, an accessible name and a dot for pending invitations. Hovering the rail restores the label without reopening the dialog. Minimal mode shows the selector only while the panel is open. Closing the phone drawer hides the selector and cancels any pending request to open its dialog. The settings breadcrumb and account menu show the workspace name. Coverage:workspace-select-reveal.test.tsx, workspace-select-trigger.test.tsx and the
sidebar case in workspace-select-invitations.test.tsx under
packages/ui/src/components/ui/custom/__tests__/.
Preference precedence
Sidebar layout preferences use a hybrid model:- Workspace override:
user_workspace_configs.SIDEBAR_NAVIGATION_LAYOUT - Account default:
user_configs.SIDEBAR_NAVIGATION_LAYOUT - Authored default layout
root: first-level tools shown directly in the sidebarmore: first-level tools shown inside More toolshidden: first-level tools archived from normal sidebar rendering
Quick actions
First-level navigation items expose compact hover actions in the sidebar:- Pin moves an item from More tools to the root sidebar.
- Unpin moves an item from the root sidebar to More tools.
- Archive hides an item from normal sidebar rendering.
Visibility rules
Preferences never bypass authorization, feature flags, production gates, root-workspace restrictions, or tier visibility. If a tool is unavailable for the current user or workspace, placing it in root navigation does not make it appear. Hidden tools remain directly routable. When the current route matches a hidden tool or one of its descendants, the sidebar reveals that item only for the current route and marks it as an active hidden item. This contextual reveal is not saved back into the preference config.Recent history
Recent sidebar navigation history is controlled byuser_configs.SIDEBAR_RECENT_NAVIGATION_ENABLED.
The default is off. When disabled, the sidebar does not render recent navigation history and does not record recent visits.