Node.js · TypeScript · 2024·Open Source

GITREPORT

GITREPORT

Client

Open Source

Year

2024

Stack

TypeScriptNode.jsRedisBullMQReactDrizzle ORMLLM / AIGitHub API

An AI-powered GitHub analytics tool that ingests commit history, classifies repositories, generates monthly developer reports with narrative summaries, and delivers them via email — built with TypeScript, Redis queues, and an LLM narrative engine.

GitReport pulls raw GitHub data via the API, runs it through an aggregation engine that computes commit patterns, language breakdowns, peak coding hours, streaks, and focus scores. Worker queues (Bull + Redis) handle async report generation and AI narrative creation. Reports can be shared publicly and exported as PDFs. The frontend is a React SPA with cinematic mode, achievement badges, and challenge cards.

Key Features

  • 01GitHub OAuth with encrypted token storage and rate-limit-aware API client
  • 02Aggregation engine: commit size distribution, language breakdown, peak hour blocks, streaks & focus score
  • 03LLM narrative generation pipeline via worker queue with persona-based report tone
  • 04PDF report export with cinematic layout using `generateReportPdf()`
  • 05Achievement system with badge evaluation and shareable public report URLs
  • 06Bull + Redis queue architecture for async ingestion, report, and narrative workers
  • 07Email notifications for report-ready and developer challenge events