Backstage Patterns

Reference for building and customizing Backstage — the open-source Internal Developer Portal from Spotify.

When to Activate

Creating or updating catalog-info.yaml for a service
Writing Backstage Scaffolder templates (Golden Paths)
Building a custom Backstage plugin
Setting up TechDocs for a service
Configuring GitHub App integration
Designing the software catalog entity model
Onboarding a new microservice into an existing Internal Developer Portal with team ownership and dependency tracking
Implementing a self-service workflow so developers can provision new services, databases, or queues through the Scaffolder UI
Migrating documentation from a wiki to TechDocs so it stays co-located with the code that it describes