0.4.0 • Published 2 years ago

@platformnow/plugin-tool-links v0.4.0

Weekly downloads
-
License
Apache-2.0
Repository
github
Last release
2 years ago

tool-links

Welcome to the tool-links plugin!

This plugin allows you to add links for external tools to your Backstage instance Homepage.

Setup

The following sections will help you get the Tool-Links plugin setup and running

Backend

You need to setup the Tool-Links backend plugin before you move forward with any of these steps if you haven't already

Installation

Install this plugin:

# From your Backstage root directory
yarn --cwd packages/app add @platformnow/tool-links

Add the plugin to your packages/app

Add the root page that the playlist plugin provides to your app. You can choose any path for the route, but we recommend the following:

// packages/app/src/App.tsx
+import { ToolLinksComponent } from '@platformnow/plugin-tool-links';


<FlatRoutes>
  <Route path="/catalog" element={<CatalogIndexPage />} />
  <Route path="/catalog/:namespace/:kind/:name" element={<CatalogEntityPage />}>
    {entityPage}
  </Route>
+ <Route path="/tool-links" element={<ToolLinksComponent />} />
  ...
</FlatRoutes>

Add the Tools Link Component to your Homepage packages/app/src/components/home

Add the Tools Link Component to your Homepage so you can Add/Edit/Delete Categories and Links

// packages/app/src/components/home/Homepage.tsx
+import {ToolLinksComponent} from '@platformnow/plugin-tool-links';

<Grid container item xs={12}>
+   <Grid item xs={12} md={6}>
+     <ToolLinksComponent />
+   </Grid>
    <Grid item xs={12} md={6}>
      <HomePageStarredEntities title="Favorites" />
    </Grid>
    <Grid item md={6} xs={12}>
      <HomePageRequestedReviewsCard />
    </Grid>
    ...
</Grid>

Features

View Tool Links

View Tool Links example

View Tool Expanded

View Tool Links Expanded example

Create Category

Create New Category example

Edit Category Name

Edit a Category Name

Delete Category

Delete a Category example

Create Links in a Category

Links can have an Icon image which must be placed in packages/app/public/homepage/icons Otherwise if left blank the default link image can be used.

Create New Link example

Edit Links in a Category

Edit Links in a Category