Backstage Developer Portal

Overview

Deployed and customized Backstage as the internal developer portal for the engineering organization. The portal serves as the single entry point for service discovery, documentation, CI/CD workflows, and infrastructure management.

Problem

With hundreds of microservices, teams struggled with service discovery — finding who owns what, where documentation lives, and how to interact with other services. Knowledge was fragmented across wikis, Slack channels, and tribal memory.

Solution

• Deployed Backstage with a custom service catalog plugin that automatically discovers and registers services from GitHub repositories
• Built custom plugins for CI/CD workflow management, enabling engineers to trigger and monitor pipelines directly from the portal
• Integrated TechDocs for automatic documentation generation from Markdown files in each repository
• Created a unified search experience across services, documentation, and infrastructure resources

Impact

• Reduced onboarding time for new engineers from weeks to days
• Improved service discovery and reduced duplicate service creation
• Centralized documentation increased knowledge sharing across teams

Technical Details

• Platform: Backstage (Spotify)
• Plugins: TypeScript, React
• Backend: Node.js
• Integration: GitHub API, GitHub Actions, ArgoCD