Files
backstage/plugins/config-schema
Patrik Oldsberg 820de63018 Merge pull request #6076 from backstage/rugvip/allreports
scripts/api-extractor: create and check API reports for all(most) plugins
2021-06-17 15:46:11 +02:00
..
2021-04-22 09:51:37 +02:00
2021-06-17 13:30:06 +02:00
2021-05-12 09:39:51 +00:00
2021-06-17 08:08:44 +00:00
2021-04-10 14:17:06 +02:00

config-schema

The config-schema plugin lets you browse a documentation reference of the configuration schema of a particular Backstage installation. It is intended as a tool for integrators rather than something that is useful to end users of Backstage.

Usage

The plugin exports a single full-page extension, the ConfigSchemaPage, which you add to an app like a usual top-level tool on a dedicated route.

It also exports a configSchemaApiRef without any default implementation, meaning that an API needs to be registered in the app for the plugin to work. An implementation of the API that is provided out of the box is the StaticSchemaLoader, which loads the schema from a URL. It can be added to the app by adding the following to your app's api.ts:

createApiFactory(configSchemaApiRef, new StaticSchemaLoader());

The configuration schema consumed by the StaticSchemaLoader can be generated using the following command:

yarn --silent backstage-cli config:schema --format=json