Skip to main content

Dashboard

The Workspaces dashboard is your at-a-glance overview of activity, projects, members, events, tags, and system health across the workspaces you belong to. It is rendered as a configurable widget grid by the host app shell (not under /workspaces/...).

Header controls​

The top bar carries the page title and two actions:

  • Refresh — re-fetches all dashboard queries (workspace data, global tenant data, projects). The button shows a spinner while loading.
  • Customize — opens the dashboard customizer drawer for choosing which widgets to show and their order.

If any of the underlying services is unreachable, a banner appears under the header (Some data may be unavailable. Workspace services may be down. Global services may be down.) with a Try refreshing action. Individual widgets still render with whatever data they could load.

Widget grid​

Widgets are arranged in a responsive grid. Each widget renders in small, medium, or large size. The default layout includes:

WidgetWhat it showsDefault size
WelcomeGreeting and overview statisticslarge
Quick ActionsFrequently used shortcutsmedium
WorkspacesYour workspaces overview and quick accessmedium
ProjectsRecent projects and status breakdownmedium
Recent ActivityTimeline of recent events across moduleslarge
Upcoming EventsNext calendar eventsmedium
WorkflowsActive workflow stats and recent runsmedium
TagsPopular tags across your workspacesmall
StorageStorage usage and file statisticssmall
GroupsYour groups and teamssmall
MembersWorkspace member overviewsmall
System StatusService health and availabilitysmall
Tips & ResourcesGetting-started tips and documentationsmall

The Welcome widget is not removable; every other widget can be hidden or reordered.

Customizing the dashboard​

  1. Click Customize to open the customizer.
  2. Toggle widgets on or off.
  3. Drag (or use the controls) to reorder them.
  4. Save your changes.

Your preferences are stored against your user profile via the global tenant service (updateDashboardPreferences) and apply to every device you sign in on. If you've never customized, the default layout above is used. When new widgets are released, they appear at the bottom of your list as disabled so they don't disrupt your layout — toggle them on if you want them.

Data sources​

Widgets pull from multiple sources in parallel:

  • The workspace gateway provides activity, calendar events, tags, groups, workflow stats, and storage.
  • The global gateway provides your workspaces and organizations, dashboard preferences, and system health.
  • A separate query fetches your projects so a failure in one widget doesn't poison the others.

If only one gateway is degraded, widgets sourced from the other continue to render.

Permissions​

The dashboard itself is open to any authenticated user — no extra permission is required to render it. Individual widgets defer to the same permissions used elsewhere (e.g. you only see workspaces you belong to, projects you have access to, activity you can read). Widgets simply omit data you can't see; they do not throw access-denied errors at the page level.