ENGINEERING • ARCHITECTURE SPECIFICATIONS
SYSTEM ARCHITECTURE.
Technical blueprint of OpenSourceHub: Next.js 15 App Router, Neo-Brutalist design tokens, GSAP motion engine, and taxonomy pipelines.
1. Core Technology Stack
FRAMEWORK
Next.js 15 (App Router)
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.
STYLING SYSTEM
Tailwind CSS & Neo-Tokens
Custom high-contrast palette, 2px borders, Space Mono & Plus Jakarta Sans typography.
MOTION ENGINE
GSAP 3.x + Lenis Scroll
Smooth inertia scrolling, counter ticker animations, and responsive reduced-motion fallbacks.
2. Component & Layout Pipeline
ROOT LAYOUT HIERARCHY:
├── RootLayout (globals.css, fonts)
├── SmoothScrollProvider (Lenis hook)
├── Navbar (sticky header, desktop/mobile links)
├── PageTransition (route motion wrapper)
├── <main> Page Views (/projects, /issues, /login)
└── Footer (tribal strip, sitemap, 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: Verified beginner documentation and labels.
Repository Health Index: CI/CD status, MIT/Apache license verification, and activity.
Explore the Codebase
OpenSourceHub is 100% open source under the MIT License.