backstage-plugin-library-tracker

Frontend plugin for Library Tracker — org-wide third-party dependency visibility for Backstage.

Install

yarn --cwd packages/app add backstage-plugin-library-tracker

Usage — new Backstage frontend system

Import from the /alpha subpath. The plugin self-registers its page, sidebar nav item, and entity tabs — no manual wiring needed.

import libraryTrackerPlugin from 'backstage-plugin-library-tracker/alpha';

const app = createApp({
  features: [libraryTrackerPlugin],
});

Usage — legacy frontend system

Org-wide page — packages/app/src/App.tsx:

import { LibraryTrackerPage } from 'backstage-plugin-library-tracker';

<Route path="/library-tracker" element={<LibraryTrackerPage />} />;

Entity tab — packages/app/src/components/catalog/EntityPage.tsx:

import {
  EntityLibraryTrackerContent,
  SystemLibraryTrackerContent,
  LibraryTrackerIcon,
} from 'backstage-plugin-library-tracker';

// Component entity page
<EntityLayout.Route path="/dependencies" title="Dependencies">
  <EntityLibraryTrackerContent />
</EntityLayout.Route>

// System entity page
<EntityLayout.Route path="/dependencies" title="Dependencies">
  <SystemLibraryTrackerContent />
</EntityLayout.Route>

Sidebar icon — packages/app/src/components/Root/Root.tsx:

import { LibraryTrackerIcon } from 'backstage-plugin-library-tracker';

<SidebarItem icon={LibraryTrackerIcon} to="library-tracker" text="Library Tracker" />

What it provides

• Overview dashboard — stat cards, drift breakdown, ecosystem distribution
• All dependencies — org-wide filterable table
• Package search — reverse lookup: which components use a library and at which versions
• Outdated / Unused / Duplicate versions — focused reports
• Entity tab — one component's dependencies with on-demand rescan
• System tab — aggregated dependencies for all components owned by a team
• Code-occurrence viewer — exact files and lines where a library is imported, with VCS links

Full documentation

See the main repository README for full setup, configuration, screenshots, and API reference.

License

MIT