About @grafana/scenes

@grafana/scenes provides a library to build highly interactive, dashboard-like experiences in Grafana's app plugins. It comes with the following features:

- Versatile layout options.
- Grafana panels rendering.
- Querying & transformations support
- Multiple time ranges support.
- Template variables support.
- URL sync.
- ... and more.

For library documentation go to https://grafana.com/developers/scenes.

Development

To work on @grafana/scenes SDK, please follow the guides below.

$3

To setup scenes with local Grafana, the following setup is required:

1. Clone the Grafana Scenes repository.
1. Clone the Grafana repository and follow the Development guide.
1. Setup env variable GRAFANA_PATH to point to your Grafana repository directory, export GRAFANA_PATH=
1. From Grafana Scenes root directory run ./scripts/dev.sh. This will compile @grafana/scenes with watch mode enabled and link it to your Grafana.
1. From Grafana directory run yarn install.

If you are working on a feature in core, that needs a certain Scenes change:

1. Add the "release" label to your PR. This will create a release for each commit you make and one when the PR is merged.
2. Update the @grafana/scenes version in package.json to use the release you want to try
3. Let people review your PR with this change
4. Merge your Scenes PR
5. Bump the Scenes version in core Grafana
6. Sync with your branch
7. Merge PR into grafana/grafana

$3

1. Run YARN_IGNORE_PATH=1 yarn link from packages/scenes directory.
1. Run yarn dev from packages/scenes directory.
1. Run yarn link @grafana/scenes from app plugin directory.
1. Start app plugin development server.

$3

Alternatively, use the demo app included in this repository.