Skip to content

Latest commit

 

History

History

org

Org Plugin for Backstage

Disclaimer: If you are looking for documentation on the experimental new frontend system support, please go here.

Features

  • Show Group Page
  • Show User Profile
  • Quick access to Groups

Group Page

Here's an example of what the Group Page looks like:

Group Page example

User Profile

Here's an example of what the User Profile looks like:

Group Page example

MyGroupsSidebarItem

The MyGroupsSidebarItem provides quick access to the group(s) the logged in user is a member of directly in the sidebar.

To use the MyGroupsSidebarItem you'll need to add it to your Root.tsx - found at packages\app\src\components\Root - like this:

+ import { MyGroupsSidebarItem } from '@backstage/plugin-org';
+ import GroupIcon from '@material-ui/icons/People';

<SidebarPage>
    <Sidebar>
      //...
      <SidebarGroup label="Menu" icon={<MenuIcon />}>
        {/* Global nav, not org-specific */}
        //...
        <SidebarItem icon={HomeIcon} to="catalog" text="Home" />
+       <MyGroupsSidebarItem
+         singularTitle="My Squad"
+         pluralTitle="My Squads"
+         icon={GroupIcon}
+       />
       //...
      </SidebarGroup>
    </ Sidebar>
</SidebarPage>

Once added MyGroupsSidebarItem will work in three ways:

  1. The user is not logged in or the logged in user is not a member of any group: the MyGroupsSidebarItem will not display anything in the sidebar

  2. The user is logged in and a member of only one group: the MyGroupsSidebarItem will display a single item in the sidebar like this:

    MyGroupsSidebarItem single example

  3. The user is logged in and a member of more than one group: the MyGroupsSidebarItem will display a single items with a sub-menu with all the related groups like this:

    MyGroupsSidebarItem multiple example