System Architecture
How GitScope Works Under the Hood
Designed according to modern SaaS production principles: clean architecture, robust security, strict TypeScript typing, and empirical GitHub data integrity.
Server-Side Token Security
All calls to GitHub GraphQL and REST APIs are executed strictly via Next.js Route Handlers. Personal access tokens never reach client browser bundles.
Zero Hallucinated Metrics
Every metric—total stars, forks, followers, languages, and repo timelines—is computed directly from raw official GitHub API JSON responses.
React Server & Client Components Split
Optimized hybrid layout: static page shells render server-side for maximum SEO, while charts and interactive filters utilize TanStack Query client components.
Caching & Performance Pipeline
Leveraging Next.js extended fetch cache with stale-while-revalidate strategy for instant responses and minimal API rate-limit impact.
Production Tech Stack
Framework Next.js 16 (App Router)
Language TypeScript (Strict mode)
Styling Tailwind CSS v4
Data Fetching TanStack Query (React Query v5)
State Management Zustand
Validation Zod Schemas
Data Visualization Recharts
Icons & Typography Lucide React & Geist Font
API Pipeline GitHub REST & GraphQL API