Concepts

Backstage

Spotify's open-source platform for building developer portals, with service catalog, templates, and extensible plugin system.

seed#backstage#spotify#developer-portal#cncf#plugins#catalog

What it is

Backstage is an open-source platform created by Spotify and donated to CNCF for building developer portals. It provides a service catalog, project templates, and an extensible plugin system.

Core components

  • Software Catalog: inventory of all services, libraries, and resources
  • Software Templates: new project scaffolding
  • TechDocs: integrated documentation as code
  • Search: unified search across plugins

Popular plugins

  • Kubernetes: deployment status
  • CI/CD: GitHub Actions, Jenkins, ArgoCD
  • Cloud: AWS, GCP cost dashboards
  • Observability: Grafana, PagerDuty

When to use Backstage

  • Organization with >50 developers
  • Multiple teams and services
  • Need for standardization
  • Dedicated platform team to maintain it

Backstage alternatives

PlatformTypeStrengthLimitation
BackstageOpen source (CNCF)Maximum customization, plugin ecosystemRequires dedicated team to maintain
PortCommercialQuick setup, polished UILess customizable, per-user cost
CortexCommercialService maturity scorecardsCatalog-focused, less extensible
OpsLevelCommercialPre-built integrationsLess flexible than Backstage

Why it matters

Backstage transformed the idea of a developer portal from a Spotify internal project to an industry standard. For organizations with dozens of services and teams, it is the way to make infrastructure, documentation, and tools discoverable from a single place.

References

Concepts