The fragmentation problem
A company grows → N repositories, N CI pipelines, N dashboards, N APIs, N services, N docs. Every developer wastes time searching: “where’s service X’s runbook?”, “who owns Y?”, “how do I deploy Z?”. Spotify internally builds a portal to centralise discovery.
The release
Backstage is released open source by Spotify on 16 March 2020. Lead: Lee Mills and Spotify R&D team. Apache 2.0 licence. Written in TypeScript (React + Node.js). Donated to CNCF in September 2020, incubating since March 2022.
Core components
Software Catalog
- Component — microservice, library, website
- API — OpenAPI, gRPC, AsyncAPI, GraphQL
- Resource — database, queue, bucket
- System — logical grouping
- Domain — business domain
- User/Group — ownership
- Template — scaffolder
Defined in catalog-info.yaml in the repo itself (verified source).
TechDocs
Docs-as-code: MkDocs Material with Markdown in repo, rendered in the portal. Versioned like code.
Software Templates
Scaffolder: creates new project from template (Git repo + PR + CI pipeline + catalog entry) in a few clicks.
Search
Search across catalog, docs, code.
Plugin ecosystem
300+ community plugins:
- GitHub/GitLab/Bitbucket — pull requests, insights
- Kubernetes — cluster view per service
- ArgoCD / FluxCD — deployment status
- Prometheus/Grafana/Datadog — metrics
- PagerDuty / Opsgenie — on-call
- Jira / Linear — issue trackers
- SonarQube — code quality
- CircleCI / GitHub Actions / Jenkins — CI
- AWS / GCP / Azure — cloud resources
Advanced features
- Custom scaffolder actions (Ansible, Terraform, API calls)
- Entity processors — validation pipeline
- Policy/RBAC — permission framework
- Notifications
- Authentication providers — GitHub, GitLab, OAuth2, SAML, OIDC, Auth0, Okta, Azure AD, Google, LDAP
Companies using it
Publicly declared adoption: Spotify, American Airlines, Expedia, LinkedIn, Netflix (partial), Mercedes-Benz, HP, VMware, hundreds of others.
Competitors / complements
- Port — commercial, Backstage-alternative SaaS
- Cortex — commercial, service catalog
- OpsLevel — commercial
- Humanitec — IDP orchestrator
- Compass (Atlassian, 2022) — Jira-integrated
In the Italian context
Backstage is adopted in:
- Large Italian enterprises with 100+ services (telco, banks, insurance)
- Platform engineering teams
- Digital PA — multi-team scale projects
- MSPs — client service catalog management
- Companies with 50+ developers wanting to standardise DX
Requires development investment (Backstage is a framework, not a plug-and-play product): dedicated platform engineering teams customise it with internal plugins.
References: Backstage (Spotify, open source 16 March 2020). Apache 2.0 licence. Written in TypeScript (React + Node). CNCF incubating (March 2022). Core: Software Catalog, TechDocs, Software Templates, Search. 300+ community plugins.