Backstage continues in assess with the Taycan team joining the evaluation. Our custom plugins for service scaffolding and API catalog are functional but require significant maintenance. We are weighing whether the developer portal benefits justify the ongoing investment compared to lighter-weight alternatives.
What We Built
Our Backstage instance includes four custom plugins:
| Plugin | Purpose | Maintenance effort |
|---|---|---|
| Service Scaffolder | Generates new services from team-specific templates | Medium — templates need updating when conventions change |
| API Catalog | Aggregates OpenAPI specs from all services into a searchable catalog | Low — mostly automated via CI |
| Tech Radar | Embedded tech radar visualization (ironically, this very radar) | Low — reads from published data |
| Runbook Viewer | Surfaces operational runbooks linked to service entities | High — keeping runbooks current is a cultural challenge |
The Maintenance Question
Backstage's plugin architecture is powerful but demands ongoing investment:
- Upgrade cadence — Backstage releases weekly. We fell behind by 3 months and the catch-up migration took a full sprint.
- Plugin API changes — the new frontend system (v2 plugin API) requires rewriting all our custom plugins
- Build time — the Backstage app takes 4+ minutes to build; local development requires running a separate backend process
The 911 team estimates they spend ~15% of one engineer's time maintaining the Backstage instance.
Alternatives Under Consideration
- Port (getport.io) — managed developer portal with lower maintenance overhead
- Custom lightweight portal — a thin Next.js app consuming the same data sources, without the Backstage framework
- Enhanced README standards — investing in service READMEs and GitHub Actions-powered automation instead of a centralized portal
Decision Criteria
We will decide by Q1 2026 based on:
- Does the new frontend system reduce our maintenance burden?
- Can we justify the engineering cost for 4 teams, or is this only valuable at larger scale?
- Do developers actually use the portal daily, or just for onboarding?
Usage analytics show the API Catalog gets 50+ daily views, but the scaffolder is used ~3 times per month. This asymmetry suggests we might be better served by keeping the catalog and dropping the full Backstage instance.
Official Website GitHub Repository What is Backstage?
