> For the complete documentation index, see [llms.txt](https://docs.lleverage.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lleverage.ai/platform/project-dashboard.md).

# Project Dashboard

The project dashboard is the customisable home page of a project. It combines stat tiles, charts, and ready-made components in a flexible grid, so each project can surface exactly what its team needs. Builders design the dashboard, including a separate layout for the operators who run workflows day to day.

### Key Features

* Stat tiles giving quick counts and entry points for the main areas of the project
* A drag-and-drop grid of widgets, with rows of up to four columns
* Charts and stats built from your project's own data, with filters, scoping, and targets
* AI-generated widgets and AI commentary on your data
* Ready-made standard components such as recent items, quick links, and text blocks
* Separate layouts for builders and operators

### Builder View and Operator View

The dashboard has two layouts:

* **Builder View**: the layout builders see, geared towards building and monitoring.
* **Operator View**: a separate layout shown to operators and members when they open the project.

Builders can switch between the two with the view menu in the dashboard header. Editing while in Operator View changes what operators will see, so you can design a focused home page for the people who run your workflows without exposing builder tools.

> 💡 Dashboard layouts are shared across the project. Everyone sees the same layout for their view, rather than a personal arrangement.

### How to Edit the Dashboard

1. **Open edit mode**: click the pencil button in the dashboard header (builders only).
2. **Make your changes**: add, move, resize, or remove tiles and widgets.
3. **Keep your changes**: click the tick button (Done).
4. **Or discard them**: click the cross button (Discard changes) to revert everything since you started editing.

### Stat Tiles

A row of tiles at the top of the dashboard gives quick counts and shortcuts for **Workflows**, **Apps**, **Knowledge**, **Tables**, **Requests**, and **Agent**.

* In edit mode, remove a tile with its minus button. Removed tiles show as dashed placeholders you can click to bring back.
* Drag tiles to reorder them.
* Some tiles only appear when the related feature is available in your project, and the Knowledge tile is not shown in Operator View.

### The Widget Grid

Widgets sit in a grid made of rows, each holding up to four columns:

* **Add a row**: hover between rows and click the plus button that appears.
* **Move a widget**: drag it to another cell. Dropping it on an occupied cell swaps the two widgets.
* **Resize a widget**: drag its edge handle to make it span more or fewer columns.
* **Delete a row**: use the bin icon on the row. If the row contains widgets, you'll be asked to confirm.
* **Start over**: use the Reset view option in edit mode to return to the default layout.

### How to Add a Widget

1. **Start**: in edit mode, click an empty cell marked "Add".
2. **Choose a widget**: pick a chart or stat type, or one of the standard components. A search box helps you find things quickly.
3. **Connect to data**: for charts and stats, choose the source the data comes from: Sessions, Requests, Data Tables, Tracked Metrics, or Activity.
4. **Shape the result**: set what to count or measure, what to split it by, and how it should look.
5. **Finish**: click "Add Widget". You can reopen any widget later to edit or delete it.

While connecting a widget to data you can also set:

* **Widget filters**: only rows matching your filters are counted. Options include time range, environment, status, trigger type, workflow, and users.
* **Data scope**: use all data or limit the widget to specific workflows, with an option to compare workflows against each other.
* **Date range**: from Today through Last 7 days and This month up to All time.
* **Target**: give a metric a goal, and the widget shows progress towards it.
* **Custom title**: name the widget yourself instead of using the generated one.

### Visualisation Types

Widgets come in several visual forms:

* **Stats**: Big Number and Progress bar, for single headline figures.
* **Charts**: Bar chart, Line chart, Area chart, Horizontal bar, and Scatter, for comparisons and trends.
* **Proportions**: Pie chart, Donut chart, and Funnel, for how a whole breaks down.
* **Browse**: Table, for scanning individual rows of data.

### Generating Widgets with AI

Instead of configuring a widget by hand, choose **Generate with Lleverage** in the widget picker and describe the insight you want in plain language, for example "Show me the time saved this month with a trend compared to last month". Press Generate and the widget is built for you, ready to tweak like any other.

You can also switch on **AI insight** when setting up a widget. This adds a short AI-generated comment to the widget that explains what the data shows.

> 💡 If a search in the widget picker comes up empty, generating is a quick way to build exactly what you had in mind.

### Standard Components

Alongside data widgets, the picker offers ready-made components you can drop straight onto the dashboard:

* **Agent Chat**: start a message to the project's agent.
* **Recently Opened**: jump back to things you were working on.
* **Workflows**, **Apps**, **Sessions**, **Requests**, **Notifications**, **Knowledge Bases**, **Data Tables**, **Project Members**: browsable lists of those areas of the project.
* **Failed Runs** and **Successful Runs**: recent run outcomes at a glance.
* **Quick Links**: a set of shortcuts you define.
* **Text Block**: your own text, for guidance or announcements.
* **Navigation Button**: a prominent button that takes people to a page you choose.

> 💡 Some components are only available in Builder View or when the related feature is enabled in your project.

### Dashboards on the Monitor Tab

The project dashboard is the project's home surface. The Monitor tab has its own dashboard, built with the same widget system but focused on run analytics: each saved view there carries its own layout of stat cards, charts, and the activity table, edited with the pencil button and saved with "Update view".

Charts built on the Monitor tab can be pinned to the project dashboard with the pin button (Pin to dashboard). A chart pinned from a saved view stays in step with that view's filters; otherwise it keeps the filters that were applied when you pinned it.

> 💡 Build run analytics on the Monitor tab, then pin the charts worth seeing every day to the project dashboard. See [Activity Monitoring](/platform/activity-monitoring.md) for the Monitor tab itself.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.lleverage.ai/platform/project-dashboard.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
