Centralized platforms providing developers with documentation, APIs, tools, and service catalogs in one place.
A developer portal is a centralized platform where developers find everything they need: service catalog, API documentation, project templates, health dashboards, and self-service tools.
| Component | Function | Example |
|---|---|---|
| Service catalog | Inventory of microservices, owners, dependencies | Backstage Software Catalog |
| Documentation | Centralized, searchable technical docs | TechDocs, Docusaurus |
| Templates | Scaffolding with best practices | Golden paths |
| Plugins | Integrations with CI/CD, cloud, observability | Kubernetes, Grafana, PagerDuty |
| Scorecards | Service maturity evaluation | Cortex, OpsLevel |
Backstage (Spotify, CNCF) is the most popular open-source platform for developer portals. Extensible through plugins.
A developer portal centralizes access to services, documentation, APIs, and internal tools. Without it, developers waste time searching for information scattered across wikis, Slack, and repositories. It is the discovery layer that makes the internal platform scalable.
Discipline focused on optimizing developer productivity, satisfaction, and effectiveness through well-designed tools, processes, and environments.
Discipline designing and building internal self-service platforms so development teams can deploy and operate applications autonomously.
Spotify's open-source platform for building developer portals, with service catalog, templates, and extensible plugin system.
Practices and tools for documenting APIs clearly, interactively, and maintainably, from OpenAPI specifications to documentation portals.
Recommended, pre-configured paths for common development tasks incorporating best practices, reducing cognitive load for teams.
Internally built platforms abstracting infrastructure and operations complexity, providing self-service to development teams.