Developer Portal Stack (Backstage, GitHub, OpenAPI, Markdown, TypeScript) overview

An internal developer portal architecture for centralizing service discovery, API documentation, software templates, and developer tooling. Backstage provides the plugin-based portal framework with a software catalog that indexes all services, libraries, and data pipelines from GitHub repositories. Swagger/OpenAPI specs power interactive API documentation rendered within the portal. Markdown drives documentation-as-code, with TechDocs building and publishing docs from repository markdown into the portal. TypeScript is used to build custom Backstage plugins for cost dashboards, deployment status, and on-call schedules. GitHub serves as the source of truth for repository metadata, CI status, and team ownership. This stack suits organizations with 50+ services where discoverability, onboarding speed, and API governance are critical. The tradeoff is ongoing curation — a portal is only useful if its catalog stays current.