Appearance
Dashboards & Widgets
Dashboards visualize catalog data. The Home dashboard is shared by the organization; you can also create your own.

Create a dashboard
- In the sidebar, click New → New dashboard, give it a name (the demo has
mydash). - A fresh dashboard is empty:

Add widgets
Click Add widget (or Edit on an existing dashboard, then Add widget):

| Widget | Use it for |
|---|---|
| Number chart | count / sum / average of entities — e.g. "Services: 7" |
| Pie / bar / line chart | entities grouped by a property — e.g. Repository by language — or counted over time — e.g. Deployments per week (see below) |
| Entity table | a filtered table of entities embedded in the dashboard |
| Markdown | free-form text — welcome notes, links, runbooks |
| Embed (iframe) | any external https page (Grafana, status pages…) |
Each widget is configured with a blueprint + filter + property — e.g. the demo's Deployments by Status pie is the deployment blueprint grouped by status.
Charts over time
A bar chart becomes a time series when its Group by is Creation time, or Property value with a date property (format date or date-time, e.g. a pull request's Merged At). Pie charts only group by categorical values.
A line chart is always a time series. You choose:
- X axis — Creation time (when the entity was created in the catalog) or any date property of the blueprint, e.g. a release's Published At.
- Interval (per hour / day / week / month, in UTC) and Time range; empty buckets between the first and last entity are shown as zero.
- Split lines by (optional) — an entity property; you get one line per value, e.g. pull requests opened per week, split by status. The eight largest values get their own line; the rest are folded into Other.
Folder dashboards
A dashboard can live inside a catalog folder: pick the folder when you create it (or move it later by drag & drop in the sidebar). Dashboards are listed before the folder's entity pages, so a folder can open on an overview of its data — the demo does this for both GitHub folders:
- Github → GitHub Overview — repositories / open PRs / open issues / releases counters, pull requests by status and per week (split by status), repositories by language, issues and releases per month, branches by last-commit week, and a table of the open pull requests.
- Github → Security → Security Overview — open Dependabot / critical+high / code scanning / secret scanning counters, Dependabot alerts by severity, state, ecosystem, scope and package, code scanning alerts by severity, tool and rule, and a table of the open critical/high Dependabot alerts.
Pick charts that have spread
A time series needs entities spread over time: if every entity was created the same day (the first sync of a freshly enabled scanner, for instance), a "per month" line is a single point. Group by a categorical property (severity, rule, package…) instead.
Dashboards can also be created and updated through the API (POST / PATCH /v1/dashboards, with folderId and a widgets[] array), which is how the demo keeps its two folder dashboards as versioned JSON files.
Arrange and save
In Edit mode, drag widgets to move them and drag corners to resize; the grid reflows automatically. Click Save to persist (or Cancel to discard). Widgets refresh their data automatically from the catalog.
