Preview

Use diver preview to test dashboards from your local *.diver.yml files before you publish them to the workspace.

Preview is designed for iteration. It uploads your local resources into a personal preview dashboard group, opens that group in Diver, and keeps the dashboards out of the shared workspace list until you publish them.

diver preview dashboards.diver.yml

How previews work

Each preview belongs to your user account and is stored in a personal preview dashboard group. Running the command again with the same resource name updates the existing preview instead of creating a new public dashboard.

Preview dashboards can be reviewed in the product like any other dashboard in a group, but they are not published workspace dashboards. This keeps local work in progress out of the main dashboard list.

Preview one file

Pass a specific resource file when you only want to preview one dashboard package:

diver preview dashboards.diver.yml

Preview a project

Run the command without a file to discover every *.diver.yml file below the current directory:

diver preview

This is useful when a repository contains multiple dashboard resources.

Print links without opening the browser

Use --no-open to print URLs without opening the browser:

diver preview --no-open

Share a preview

Dashboards are shared through dashboard groups. To let teammates review a preview, share the personal preview dashboard group from Diver.

Direct sharing of an individual preview dashboard is not supported. When the dashboard is ready for everyone in the workspace, publish it with diver publish.

Before you run preview

Make sure the source names referenced in the YAML exist in Diver. Source resource names are managed in the web app and can be listed locally with:

diver sources