# port-labs/backstage-plugin architecture

> Architecture diagram of the GitHub repository port-labs/backstage-plugin, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/port-labs/backstage-plugin
- Repository: https://github.com/port-labs/backstage-plugin

## Overview

##### Integration Points

- Plugin-to-Backstage integration
- External service integrations (mentioned as 50+ tools)
- Scorecard engine connections
- API layer interactions

##### Key Architectural Elements

Frontend Architecture:
**Components -> Features -> Pages -> Routes**

- API Hooks Layer

Backend Architecture:
**Router -> Service Layer -> API Layer**

- Authentication/Authorization

##### Component Details

For each plugin, show:
- Component structure
- Route handling
- API integration points
- Feature modules

##### Data Flow

- Plugin initialization flow
- API request/response paths
- Integration data flow
- Scorecard evaluation flow

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Styles and classes
    classDef frontend fill:#3498db,stroke:#2980b9,color:white
    classDef backend fill:#2ecc71,stroke:#27ae60,color:white
    classDef integration fill:#e67e22,stroke:#d35400,color:white
    classDef core fill:#9b59b6,stroke:#8e44ad,color:white
    classDef beta fill:#95a5a6,stroke:#7f8c8d,color:white

    %% Frontend Layer
    subgraph Frontend
        FE_Core["Frontend App Core"]
        PluginReg["Plugin Registry"]
        Router["Routing System"]
        EntityMgmt["Entity Management"]
        
        subgraph Plugins
            DevDaily["Dev Daily Plugin"]
            DevExSurvey["DevEx Survey Plugin"]
            DevTools["DevTools Plugin"]
            FrontendPlugin["Frontend Plugin"]
            
            subgraph FrontendFeatures
                Scorecards["Scorecard System"]
                Actions["Actions Framework"]
                IntegMgmt["Integration Management"]
            end
        end
    end

    %% Backend Layer
    subgraph Backend
        BE_Services["Backend Services"]
        Auth["Authentication Service"]
        BackendPlugin["Backend Plugin"]
        Config["Configuration Management"]
    end

    %% Integration Layer
    subgraph Integrations
        ExtServices["External Services"]
        APIGateway["API Gateway"]
    end

    %% Relationships
    FE_Core --> PluginReg
    PluginReg --> Router
    Router --> EntityMgmt
    
    DevDaily --> FE_Core
    DevExSurvey --> FE_Core
    DevTools --> FE_Core
    FrontendPlugin --> FE_Core
    
    FrontendPlugin --> Scorecards
    FrontendPlugin --> Actions
    FrontendPlugin --> IntegMgmt
    
    BackendPlugin --> BE_Services
    BE_Services --> Auth
    BE_Services --> Config
    
    APIGateway --> ExtServices
    BE_Services --> APIGateway
    
    FrontendFeatures --> BE_Services
    
    %% Click events
    click DevDaily "https://github.com/port-labs/backstage-plugin/tree/main/backstage-plugins/plugins/dev-daily-plugin"
    click DevExSurvey "https://github.com/port-labs/backstage-plugin/tree/main/backstage-plugins/plugins/devex-survey-plugin"
    click DevTools "https://github.com/port-labs/backstage-plugin/tree/main/backstage-plugins/plugins/devtools-plugin"
    click FrontendPlugin "https://github.com/port-labs/backstage-plugin/tree/main/backstage-plugins/plugins/frontend-plugin"
    click BackendPlugin "https://github.com/port-labs/backstage-plugin/tree/main/backstage-plugins/plugins/backend-plugin"
    click BE_Services "https://github.com/port-labs/backstage-plugin/tree/main/backstage-plugins/packages/backend"
    click FE_Core "https://github.com/port-labs/backstage-plugin/tree/main/backstage-plugins/packages/app"
    click Auth "https://github.com/port-labs/backstage-plugin/blob/main/backstage-plugins/plugins/backend-plugin/src/lib/api/auth.ts"
    click Scorecards "https://github.com/port-labs/backstage-plugin/tree/main/backstage-plugins/plugins/frontend-plugin/src/features/Scorecards"
    click Actions "https://github.com/port-labs/backstage-plugin/tree/main/backstage-plugins/plugins/frontend-plugin/src/features/Actions"
    click Config "https://github.com/port-labs/backstage-plugin/blob/main/backstage-plugins/app-config.yaml"
    click PluginReg "https://github.com/port-labs/backstage-plugin/blob/main/backstage-plugins/packages/app/src/apis.ts"
    click Router "https://github.com/port-labs/backstage-plugin/blob/main/backstage-plugins/packages/app/src/App.tsx"
    click IntegMgmt "https://github.com/port-labs/backstage-plugin/blob/main/backstage-plugins/plugins/frontend-plugin/src/pages/settings/components/IntegrationsTable.tsx"
    click EntityMgmt "https://github.com/port-labs/backstage-plugin/blob/main/backstage-plugins/packages/app/src/components/catalog/EntityPage.tsx"

    %% Styling
    class FE_Core,PluginReg,Router,EntityMgmt frontend
    class DevDaily,DevExSurvey,DevTools,FrontendPlugin frontend
    class Scorecards,Actions,IntegMgmt frontend
    class BE_Services,Auth,BackendPlugin,Config backend
    class ExtServices,APIGateway integration
    class FrontendFeatures core
```
