Backstage: The Developer Portal That Became an Industry Standard

Spotify open-sourced Backstage in 2020. By 2023 it has been adopted by hundreds of organisations including large enterprises and cloud providers. The CNCF graduated it in 2022. The journey from internal tool to industry standard is instructive.

What Backstage solves

The problem Backstage addresses is service ownership and discoverability at scale. When an organisation runs hundreds or thousands of services, finding who owns a service, what its dependencies are, where its documentation lives, what its current deployment status is, and what APIs it exposes becomes genuinely difficult. Backstage provides a single pane of glass for this information via a software catalog that pulls from CI/CD systems, source control, and infrastructure providers.

The plugin architecture

Backstage's plugin architecture is why it achieved ecosystem traction. Every integration is a plugin: Kubernetes status, GitHub Actions runs, PagerDuty on-call rotations, Sonar code quality scores, cloud cost data. The community has built over 200 plugins. Because the frontend framework is consistent (React with a shared design system), plugins integrate visually as well as functionally.

Golden path templates

Backstage's software templates feature lets platform teams publish curated starting points for new services: a template for a new .NET API includes the project scaffolding, CI/CD pipeline configuration, monitoring setup, and Backstage catalog entry, all generated from a single form. This is the golden path concept: making the right way to start a new service also the easiest way.

The enterprise investment

Implementing Backstage well requires significant investment: populating the catalog from existing systems, building or integrating the plugins relevant to your stack, and maintaining the templates as your practices evolve. The organisations that get the most value from Backstage are those that committed engineering time to make it accurate and complete. A partially populated Backstage catalog that developers learn to distrust is worse than no catalog.