Backstage Developer Portal

Build internal developer portals with Backstage. Generates catalog-info.yaml entities, software templates (Scaffolder), TechDocs configs, custom plugins, and integrates GitHub/Kubernetes/CI providers.

This skill covers Spotify's Backstage platform: defining components, systems, APIs, and resources in the software catalog via catalog-info.yaml; building Scaffolder templates that bootstrap new services with golden-path scaffolding; wiring up TechDocs (MkDocs + Backstage); writing custom frontend/backend plugins; and integrating providers for GitHub, GitLab, Kubernetes, ArgoCD, PagerDuty, and Sentry. Also covers RBAC, auth, and deploying Backstage on Kubernetes.

When to use

Use when standing up a Backstage portal, defining service catalog entities, building Scaffolder templates, writing custom plugins, or wiring TechDocs.

Examples

Service scaffolder template

Golden path for new microservices

Create a Backstage Scaffolder template that scaffolds a new Go microservice with Helm chart, ArgoCD Application, and GitHub repo bootstrapped — wire it to the catalog so the new service appears immediately

Catalog ingestion

Discover all repos automatically

Configure Backstage to auto-discover all repos in our GitHub org with catalog-info.yaml and register them as Components, grouping them by team owner