# Dashboards

URL: /code/file-conventions/dashboards · Id: `page:code/file-conventions/dashboards`

> A file in dashboards/ is one Dashboard for one scope, rendered for people, native clients and agents.

A file in `dashboards/` is one [Dashboard](/business/nouns/dashboard) for one scope: the [Startup](/business/nouns/startup), a [Team](/business/nouns/team), a [Role](/business/nouns/role), or where they meet.

```text
dashboards/
└── renewals.mdx      the success manager's Dashboard
```

## Reference
MDX: frontmatter is the scope, and the body is [Components](/business/nouns/component) with literal props.

| Key | Type | Holds |
| --- | --- | --- |
| `scope` | Startup, Team or Role path | Whose Dashboard it is |
| `title` | string | Its name |

## Examples
### Minimal
```mdx title="dashboards/renewals.mdx"
---
scope: customer/success-manager
---
<TaskInbox />
```

### Leaseline
```mdx title="dashboards/renewals.mdx"
---
scope: customer/success-manager
title: Renewals
---
<MetricTile metric="renewals.answeredRate" window="month" />
<DataTable noun="Lease" where="status = renewing" sort="endsOn" />
<TaskInbox role="customer/success-manager" />
<ApprovalSheet />
```

## What it builds
The [StartupBuilder](/code/builders/startup) compiles the file.

- a `Dashboard`, rendered as HTML for people, JSON for native clients and Markdown for agents
- the Markdown form is the first context of every agent in the scope
- `Dashboard.ask` answers questions about it in words

## Routing
`/dashboard/customer/success-manager` in the Startup's operator [App](/business/nouns/app).

## Good to know
- A Role with no file gets a derived Dashboard from its [Processes](/business/nouns/process) and [Metrics](/business/nouns/metric).