Internal Developer Platform (IDP)
Also Known As
TL;DR
Explanation
An Internal Developer Platform abstracts over Kubernetes, Terraform, cloud accounts, secrets managers, CI/CD and observability so a product team can provision a new service, environment, or database via a portal, CLI or pull request — without learning every underlying tool. Typical components: a service catalogue (Backstage is the popular open-source base), golden-path templates (generated scaffolding with pipelines, observability and security baked in), self-service provisioning (database, message queue, object storage on demand), and environment promotion workflows. The distinguishing idea is *product thinking applied to internal tools* — platform engineering treats the developers as customers and measures adoption, satisfaction and lead time. An IDP succeeds when its golden path is faster and safer than building from scratch; it fails when it becomes yet another set of gatekeepers.
Common Misconception
Why It Matters
Common Mistakes
- Shipping a portal before shipping a paved road — a service catalogue listing broken templates is worse than no catalogue.
- Treating the IDP as a project instead of a product — platforms need ongoing investment, user research and a roadmap, not a one-off rollout.
- Making golden paths the only paths — leave an escape hatch for teams with special needs, or they will go around the platform.
- Measuring adoption by login count instead of by what developers ship — the right metric is deployment lead time and change failure rate, not dashboard views.
- Building everything in-house — start with Backstage or an existing tool and customise; do not write your own portal framework before you need one.
Avoid When
- A small team with one or two services — the overhead of building and running the platform exceeds its savings.
When To Use
- Your organisation has enough services (roughly 10+) that the marginal cost of provisioning is a real drag.
- You see the same pipeline or Terraform module copy-pasted across repositories with subtle, dangerous drift.
- Compliance or security review has become a bottleneck on every new service — embed the controls in the platform.