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:
| Widget | What it shows | Default size |
|---|---|---|
| Welcome | Greeting and overview statistics | large |
| Quick Actions | Frequently used shortcuts | medium |
| Workspaces | Your workspaces overview and quick access | medium |
| Projects | Recent projects and status breakdown | medium |
| Recent Activity | Timeline of recent events across modules | large |
| Upcoming Events | Next calendar events | medium |
| Workflows | Active workflow stats and recent runs | medium |
| Tags | Popular tags across your workspace | small |
| Storage | Storage usage and file statistics | small |
| Groups | Your groups and teams | small |
| Members | Workspace member overview | small |
| System Status | Service health and availability | small |
| Tips & Resources | Getting-started tips and documentation | small |
The Welcome widget is not removable; every other widget can be hidden or reordered.
Customizing the dashboard
- Click Customize to open the customizer.
- Toggle widgets on or off.
- Drag (or use the controls) to reorder them.
- 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.