GitHub Org Tools
A Next.js 16 application that connects to GitHub via a GitHub App, ingests contributor activity, and surfaces it through configurable leaderboards and organization management tools.
Not sure where to start?
- First time here → Getting Started
- Setting up locally → Local Development
- Understanding how it works → Architecture Overview
- How scoring works → Scoring Pipeline
What this system does
| Capability | Status | Where to read |
|---|---|---|
| GitHub App OAuth sign-in | ✅ Production | Authentication |
| GitHub App installation (org-level) | ✅ Production | Installation |
| GraphQL proxy (8-op allowlist) | ✅ Production | GraphQL Proxy |
| Bulk org member invitations | ✅ Production | Organizations |
| Contributor leaderboards | ✅ Production | Scoring Overview |
| Team leaderboards | ✅ Production | Scoring Pipeline |
| Repository leaderboards | ✅ Production | Scoring Pipeline |
| Configurable scoring presets | ✅ Production | Presets & Configuration |
| Repository analytics endpoint | ✅ Production | Organizations |
| Analytics dashboards / heatmaps | 🚧 Planned | Analytics Guide |
| Team management UI | 🚧 Planned | Organization Management |
| Role management UI | 🚧 Planned | Organization Management |
Documentation sections
Getting Started
Environment setup, local development, and environment variable reference.
Architecture
System structure, request lifecycle, data flow diagrams, and the caching model.
Backend
Every API route, the auth system, GraphQL proxy, webhooks, and background jobs.
Scoring
The three-phase ingest → score → serve pipeline, the scoring engine, and preset management.
Database
Complete schema reference, the repository layer, and migration management.
Infrastructure
Vercel deployment, CI/CD pipeline, security model, and monitoring posture.
Guides
How-to walkthroughs for organization management, leaderboards, and analytics.
Contributing
Developer onboarding, project structure, and workflow.
Troubleshooting
Common errors, their causes, and fixes.