Backstage Plugins

A collection of plugins that extend Backstage to help with developer onboarding, context switching, and automated IDE environments (remote or local).

• backstage-plugin-coder: A plugin for integrating Coder workspaces with Backstage.
• backstage-plugin-devcontainers-backend: A plugin for integrating VS Code Dev Containers extension with Backstage catalog items (no Coder deployment necessary).
• backstage-plugin-devcontainers-react: A plugin for allowing you to detect and work with Dev Containers repo data added by backstage-plugin-devcontainers-backend, namely letting you open a repo in VS Code with a full Dev Containers setup (no Coder deployment necessary).

Please use GitHub issues to report any issues or feature requests.

Contributing

To start the app:

yarn install
yarn dev

To run an individual plugin:

cd plugins/backstage-plugin-$name
yarn install
yarn start

Note that the Coder plugin does not support running like this as it currently uses a backend proxy that is not available when running independently of the Backstage app.

Releasing

To draft a release for a plugin push a tag named $name/v$version without the backstage-plugin- prefix. For example:

git tag -a coder/v0.0.0 -m "coder v0.0.0"
git push origin coder/v0.0.0

This will kick off an action that will create a draft release for the plugin. Once you have reviewed the release you can publish it and another action will publish the plugin to NPM.