27 lines (17 loc) · 700 Bytes

ADR-007: Backstage as Developer Portal

Status: Accepted

Date: 2026-01-25

Context

Need to automate the creation of new services and maintain a centralized catalog.

Decision

Adopt Backstage as Developer Portal with Software Templates for automated scaffolding.

Rationale

Open source with active community (Spotify)
Software Templates automate creation of repos, pipelines, and GitOps config
Software Catalog centralizes service inventory
Native integration with GitHub, Kubernetes, Argo CD
TechDocs enables integrated documentation

Consequences

Need to keep templates updated
Additional PostgreSQL for persistence
Learning curve for plugin customization