Skip to content

Architecture and data

Runtime

mermaid
flowchart LR
  GH[GitHub GraphQL and Events APIs] --> P[Node.js ingestion]
  SO[Stack Overflow API] --> P
  P --> C[(Azure Cosmos DB)]
  C --> N[Next.js API and MCP]
  N --> V[Vercel application]
  V --> H[Human users]
  N --> A[AI agents]
  R[Repository Markdown] --> VP[VitePress build]
  VP --> GP[GitHub Pages docs]

The React 19 and Next.js 15 application runs on Vercel. Azure Cosmos DB stores indexed profiles, vector embeddings, activity, private user-scoped features, and consent records in separate containers. Azure Functions invoke scheduled ingestion and snapshot endpoints. Documentation is a static VitePress artifact deployed independently to GitHub Pages.

Data sources

  • GitHub GraphQL supplies profiles, followers, repositories, stars, forks, languages, and contribution counts.
  • GitHub Events supplies a best-effort recent activity feed.
  • Stack Overflow supplies matched reputation, answers, acceptance rate, and badges.
  • Geocoding converts public free-form locations into approximate globe coordinates.

Freshness and limitations

Source metrics are snapshots, not live counters. GitHub Events may delay or omit events. Stack Overflow matching can be unavailable. Geocoded locations are approximate. The UI marks stale or unknown freshness where possible.

Privacy boundaries

Public developer documents are kept separate from private contacts, watchlists, saved searches, notification preferences, agent credentials, and introduction decisions. Public APIs project allowlisted fields rather than returning complete database records.

Public contribution discovery for humans and AI agents.