A professional-grade Developer Portal built on Spotify's Backstage, providing a unified interface for software cataloging, automated scaffolding, and centralized technical documentation.

Software Catalog: Centralized management of services, APIs, and resources.

Software Templates (Scaffolder): Automated "Golden Path" creation for Go Services, including automatic GitHub repository initialization and Catalog registration.

TechDocs-as-Code: Documentation generated locally using MkDocs and served seamlessly through the portal UI.

CI/CD Integration: Real-time visibility into GitHub Actions workflows directly within the component dashboard.

Secure Authentication: Integrated GitHub OAuth 2.0 for secure user identity and access management.

Frontend: React, Material UI, TypeScript.

Backend: Node.js, Knex.js.

Database: PostgreSQL 16 (Running via Docker).

Infrastructure: WSL2 (Ubuntu), Docker, MkDocs.

Integrations: GitHub API, GitHub Actions, TechDocs.

1. Database Layer The portal relies on a persistent PostgreSQL instance. Connection stability is managed via custom knexConfig to handle WSL-to-Docker network latency.

docker run -d --name backstage-db -p 5432:5432 postgres:16-alpine

2. Authentication Configured via GitHub OAuth App to enable secure sign-in and facilitate Scaffolder actions on behalf of the user.

3. Entity Life Cycle The portal follows the "Fetch, Publish, Register" pattern:

Fetch: Pulls a Go service skeleton from local templates.

Publish: Creates a new repository on GitHub under the aashiruu organization.

Register: Automatically creates the catalog-info.yaml link to track the new service in the IDP.

1. Export Secrets:

export GITHUB_TOKEN=your_token

export AUTH_GITHUB_CLIENT_ID=your_id

export AUTH_GITHUB_CLIENT_SECRET=your_secret

2. Install Dependencies:

yarn install

3. Start the Engine:

yarn dev

Local TechDocs Generation: Successfully bypassed common Docker-in-Docker issues by implementing a local mkdocs build runner.

Custom Entity Pages: Modified EntityPage.tsx to include conditional CI/CD tabs and Kubernetes observability.

Database Resilience: Resolved KnexTimeoutErrors by tuning connection pool parameters for high-latency environments.