ENGINEERING • ARCHITECTURE SPECIFICATIONS
SYSTEM ARCHITECTURE.
Technical blueprint of OpenSourceHub: Next.js 15 App Router, NestJS + Fastify backend, PostgreSQL & Prisma ORM, and taxonomy pipelines.
1. Core Technology Stack
FRAMEWORK
Next.js 15 (App Router)
React 19 Server Components with Static Site Generation (SSG) & Incremental Static Regeneration (ISR).
TYPE SYSTEM
TypeScript 5.x Strict
End-to-end type safety for repository schemas, issue triage tags, and developer leaderboards.
BACKEND ENGINE
NestJS 11 + Fastify
High-throughput event-driven Fastify adapter, origin security guards, and session authentication.
DATABASE & ORM
PostgreSQL + Prisma
Relational PostgreSQL database via Supabase pooler and Prisma ORM client.
2. Component & Layout Pipeline
ROOT LAYOUT HIERARCHY:
├── RootLayout (globals.css, Plus Jakarta Sans, Space Mono)
├── AuthProvider (session state & user context)
├── Navbar (sticky glass header, search & profile)
├── <main> Page Views (/projects, /issues, /dashboard)
└── Footer (sitemap, documentation & legal links)
3. Taxonomy & Curation Engine
OpenSourceHub indexes repositories based on three primary signals:
Maintainer Responsiveness: PRs and issues triaged within 7 days.
Good First Issue Classification: GitHub issue labels and difficulty filters.
Repository Health Index: CI/CD status, MIT/Apache license verification, and activity.
Explore the Codebase
Explore how the product works and read the contribution guides. Review repository licensing before reusing source code.