@statusneo/backstage-plugin-github
TypeScript icon, indicating that this package has built-in type declarations

0.2.6 • Public • Published

GitHub Homepage Cards for Backstage Enterprise


To know more about the plugin, read this blog.

Setup

Before you can start using the GitHub cards, you must set up a GitHub provider.

You can follow this documentation which will guide you through the process of setting up the GitHub provider for your Backstage instance.

Now in the below steps, I will assume you are already done with the provider.

Integration Steps

  1. First Install the GitHub cards plugin by running this command from the root of the package.
yarn add –cwd packages/app @statusneo/backstage-plugin-github
  1. add this to the app/src/apis.ts
  import { githubApiRef, GithubClient as StatusNeoGithubClient } from '@statusneo/backstage-plugin-github';

  // ...
  createApiFactory({
    api: githubApiRef,
    deps: { authApi: githubAuthApiRef, fetchApi: fetchApiRef, configApi: configApiRef },
    factory(deps) {
      return new StatusNeoGithubClient(deps);
    },
  }),
  // ...
  1. Import GithubPullRequestsCard, and GithubActionsCard from the installed package.

  2. You can then use these components at the backstage frontend wherever you need.

import { GithubPullRequestsCard, GithubActionsCard } from '@statusneo/backstage-plugin-github';

// ...
              <Grid item xs={12} md={6}>
                <GithubActionsCard />
              </Grid>
              <Grid item xs={12} md={6}>
                <GithubPullRequestsCard />
              </Grid>
// ...
  1. If you are using a GitHub enterprise edition, you can pass your instance url through app-config.yml
gh-plugin:
  url: ${GITHUB_ENTERPRISE_URL}

Now you are ready to use this Backstage GitHub plugin to make your software management and development cycle a little more hassle-free.

Package Sidebar

Install

npm i @statusneo/backstage-plugin-github

Weekly Downloads

42

Version

0.2.6

License

ISC

Unpacked Size

104 kB

Total Files

12

Last publish

Collaborators

  • abhaysoni
  • noicecurse