The Platform (The Engine)
The IDP is the sum of all the technology, tools, APIs, and best practices your infrastructure team provides. It is the engine room that handles deploying code, provisioning databases, rotating secrets, and enforcing security policies. Developers interact with it through APIs, CLIs, or automation — often without realizing it.
The Portal (The Dashboard)
The Developer Portal is the user interface (UI) for the IDP. It is the single pane of glass that developers interact with to discover services, create new projects, trigger deployments, and read documentation.
Think of a car. The IDP is the engine, transmission, fuel injection system, and wheels. The Portal is the dashboard with the speedometer, the steering wheel, and the controls. You need the dashboard to effectively and safely control the engine — but the dashboard is useless without the engine behind it.
The most popular open-source framework for building these portals today is Backstage, originally created by Spotify and donated to the Cloud Native Computing Foundation (CNCF) in 2020. Backstage is a "portal builder" — a React-based web application framework that gives you the scaffolding to build a developer portal on top of your existing IDP.
Why Backstage Won
Before Backstage, companies built bespoke internal portals from scratch — expensive, inconsistent, and abandoned the moment the team that built them moved on. Backstage succeeded because it provided a plugin architecture that lets the community share integrations. Today there are hundreds of community plugins for tools like PagerDuty, Argo CD, Datadog, GitHub Actions, and Vault. Instead of building a Kubernetes dashboard integration from scratch, you install the community plugin in an afternoon.