🚀 github.gg

AI-Powered GitHub Analysis, Developer Arena & GitHub Wrapped

Live Demo • Documentation • Report Bug • Request Feature

🎯 What is github.gg?

github.gg is an open-source platform that transforms how developers analyze and understand GitHub repositories. Using AI-powered analysis, it provides deep insights into code quality, repository health, and developer contributions.

✨ Key Features

🎁 GitHub Wrapped — NEW!

Your year in code, Spotify Wrapped style. A viral, shareable year-in-review experience for developers.

Animated Story Experience: Instagram/TikTok-style slides with auto-advancing playback
Real-time Generation: tRPC subscriptions with SSE for live progress updates
Contribution Calendar: Beautiful heatmap visualization of your commit activity
AI Personality Insights: Get your "Developer Personality" (e.g., "The Midnight Archaeologist")
Gift to Friends: Generate wrapped for any GitHub user and send email notifications
Profile Badges: Embeddable SVG/PNG badges for your GitHub README
Star-Gate: Star the repo to unlock your Wrapped (viral growth mechanic)

Slides include: Intro → Commits & PRs → Languages → Coding Schedule → Contribution Calendar → Highlights → AI Personality → Share

🤖 AI-Powered Analysis

Repository Scorecards: Comprehensive code quality metrics with AI-generated insights
PR Code Reviews: Automated code review with security, performance, and maintainability analysis
Issue Triage: Intelligent issue classification with "slop ranking" and priority suggestions
Commit Analysis: Deep dive into commit quality and best practices

📊 Developer Tools

Interactive Diagrams: Visualize repository structure, dependencies, and file relationships
Score History: Track repository and developer metrics over time
GitHub App Integration: Automated PR reviews and issue analysis via webhooks

📚 Wiki System

AI-Generated Wikis: Automatically generate documentation for any repository
Collaborative Editing: Milkdown-based markdown editor with live preview
Version Control: Track wiki page history and changes

🏆 Arena & Dev Rank

ELO Rankings: Competitive developer rankings based on GitHub activity
Code Duels: Challenge other developers and compare skills
Leaderboards: See how you stack up against other developers

🔐 Enterprise Ready

Unified Authentication: Single better-auth OAuth with GitHub provider
GitHub App Integration: Enhanced permissions for private repos and webhooks
Installation Linking: Seamlessly connect OAuth accounts with GitHub App installations
Bring Your Own API Key (BYOK): Use your own AI API keys
Stripe Payment Integration: Pro subscriptions for advanced features
PostgreSQL + Drizzle ORM: Type-safe database operations

🚀 Quick Start

Prerequisites

Bun (recommended) or Node.js 18+
Docker (for local database)
GitHub OAuth App credentials

One-Command Setup

# Clone the repository
git clone https://github.com/lantos1618/github.gg.git
cd github.gg

# Run automated setup
bun run setup

This will:

✅ Install all dependencies
✅ Create .env.local configuration file
✅ Start PostgreSQL database with Docker
✅ Run database migrations

Configure GitHub OAuth

Go to GitHub Developer Settings
Click "New OAuth App"
Fill in the details:
- Application name: github.gg-dev
- Homepage URL: http://localhost:3000
- Authorization callback URL: http://localhost:3000/api/auth/callback/github
Copy the Client ID and Client Secret
Update your .env.local file:

GITHUB_CLIENT_ID=your_client_id_here
GITHUB_CLIENT_SECRET=your_client_secret_here

Start Development

bun dev

Open http://localhost:3000 🎉

📦 Tech Stack

Layer	Technology
Framework	Next.js 15+ (App Router, Turbopack)
Language	TypeScript 5.9
Runtime	Bun
Database	PostgreSQL + Drizzle ORM
Authentication	Better Auth (OAuth) + GitHub App
API	tRPC with SSE Subscriptions
AI	Google Gemini via Vercel AI SDK
State	Zustand + TanStack Query
GitHub	Octokit
Styling	Tailwind CSS 4 + shadcn/ui
Animations	Framer Motion
Payments	Stripe
Email	Resend + React Email
Rate Limiting	Upstash Redis
Deployment	Vercel

🏗️ Architecture

┌─────────────────────────────────────────────────────────┐
│                     Next.js App Router                   │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  │
│  │   Server     │  │   Client     │  │   API        │  │
│  │  Components  │  │  Components  │  │   Routes     │  │
│  └──────┬───────┘  └──────┬───────┘  └──────┬───────┘  │
│         │                 │                 │           │
│         └─────────────────┴─────────────────┘           │
│                           │                             │
│                    ┌──────┴───────┐                     │
│                    │     tRPC      │                     │
│                    │ + SSE Streams │                     │
│                    └──────┬───────┘                     │
│                           │                             │
│         ┌─────────────────┴─────────────────┐           │
│         │                                   │           │
│  ┌──────┴───────┐                  ┌───────┴────────┐  │
│  │   Database   │                  │   External     │  │
│  │  (Drizzle)   │                  │   Services     │  │
│  │              │                  │                │  │
│  │ • PostgreSQL │                  │ • GitHub API   │  │
│  │ • Migrations │                  │ • Gemini AI    │  │
│  │ • Caching    │                  │ • Stripe       │  │
│  │              │                  │ • Resend Email │  │
│  └──────────────┘                  └────────────────┘  │
└─────────────────────────────────────────────────────────┘

🔧 Development

Project Structure

github.gg/
├── src/
│   ├── app/                 # Next.js App Router pages
│   │   ├── wrapped/         # GitHub Wrapped feature
│   │   ├── arena/           # Developer Arena & Leaderboards
│   │   ├── wiki/            # AI-generated wikis
│   │   └── api/             # API routes (tRPC, webhooks)
│   ├── components/
│   │   ├── wrapped/         # Wrapped slides & animations
│   │   ├── arena/           # Arena UI components
│   │   ├── wiki/            # Wiki editor & viewer
│   │   └── ui/              # shadcn/ui components
│   ├── lib/
│   │   ├── ai/              # AI analysis modules
│   │   ├── auth/            # Unified auth system (better-auth)
│   │   ├── github/          # GitHub API & App integration
│   │   ├── trpc/            # tRPC routes and procedures
│   │   └── email/           # Email templates (React Email)
│   └── db/                  # Database schema (Drizzle)
├── tests/                   # Test files
├── docs/                    # Documentation
└── drizzle/                 # Database migrations

Available Scripts

bun dev                  # Start development server (Turbopack)
bun run build           # Build for production
bun run db:start        # Start PostgreSQL with Docker
bun run db:studio       # Open Drizzle Studio
bun run db:push         # Push schema changes
bun test                # Run tests

Environment Variables

See .env.example for all configuration options. Key variables:

# Required
DATABASE_URL=postgresql://...
GITHUB_CLIENT_ID=...
GITHUB_CLIENT_SECRET=...
BETTER_AUTH_SECRET=...

# AI Features
GOOGLE_GENERATIVE_AI_API_KEY=...

# Payments (optional)
STRIPE_SECRET_KEY=...
STRIPE_WEBHOOK_SECRET=...

# Email (optional)
RESEND_API_KEY=...

🤝 Contributing

We love contributions! Whether it's bug fixes, feature additions, or documentation improvements.

How to Contribute

Fork the repository
Create a feature branch
```
git checkout -b feature/AmazingFeature
```
Make your changes
- Write tests for new features
- Follow the existing code style
- Update documentation as needed

Commit your changes

git commit -m 'feat: Add some amazing feature'

Push to your fork
```
git push origin feature/AmazingFeature
```
Open a Pull Request

Development Guidelines

Code Style: Follow the existing TypeScript and React patterns
Testing: Write tests for new features (bun test)
Type Safety: Maintain 100% TypeScript coverage
Documentation: Update docs for API changes
Commits: Use Conventional Commits

Areas We Need Help

🎨 UI/UX improvements
📝 Documentation and tutorials
🐛 Bug fixes and testing
🌍 Internationalization (i18n)
⚡ Performance optimizations
🔌 New integrations and features

📚 Documentation

Setup Guide: Detailed local development setup
Activation Guide: Setting up the GitHub App
Component Patterns: React component conventions
GitHub Wrapped Spec: Wrapped feature specification

🚀 Deployment

Deploy to Vercel (Recommended)

Click the button above
Set up environment variables in Vercel dashboard
Connect your PostgreSQL database (Vercel Postgres, Supabase, etc.)
Deploy!

Manual Deployment

# Build the application
bun run build

# Start production server
bun start

Important: Run database migrations before deploying:

bun run db:push

🗺️ Roadmap

Completed

In Progress

Profile badges (SVG/PNG embeds)
Code battles and tournaments
Team analytics

Future

Historical wrapped comparison (year-over-year)
VS Code extension
Browser extension
API for third-party integrations
Self-hosted enterprise version

See the open issues for a full list of proposed features and known issues.

📊 Stats

🙏 Acknowledgments

Thanks to all contributors who have helped build github.gg
Built with amazing open-source projects: Next.js, Bun, Drizzle, tRPC, and more
Inspired by the GitHub community and the need for better code analysis tools

📄 License

Distributed under the MIT License. See LICENSE for more information.

🔗 Links

Website: https://github.gg
GitHub: https://github.com/lantos1618/github.gg
Issues: https://github.com/lantos1618/github.gg/issues
Discussions: https://github.com/lantos1618/github.gg/discussions

⭐ Star us on GitHub if you find this project useful! ⭐

Made with ❤️ by the github.gg community

Note: github.gg is not affiliated with, endorsed by, or sponsored by GitHub, Inc. GitHub is a registered trademark of GitHub, Inc.

Name		Name	Last commit message	Last commit date
Latest commit History 654 Commits
.cursor		.cursor
.vscode		.vscode
docs		docs
drizzle		drizzle
public		public
scripts		scripts
src		src
tests		tests
.env.example		.env.example
.gitignore		.gitignore
.npmrc		.npmrc
PRODUCT_ANALYSIS.md		PRODUCT_ANALYSIS.md
README.md		README.md
bun.lock		bun.lock
bunfig.toml		bunfig.toml
components.json		components.json
docker-compose.yml		docker-compose.yml
drizzle.config.ts		drizzle.config.ts
eslint.config.mjs		eslint.config.mjs
next.config.mjs		next.config.mjs
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tailwind.config.ts		tailwind.config.ts
tsconfig.json		tsconfig.json
vercel.json		vercel.json

lantos1618/github.gg

Folders and files

Latest commit

History

Repository files navigation

🚀 github.gg

🎯 What is github.gg?

✨ Key Features

🎁 GitHub Wrapped — NEW!

🤖 AI-Powered Analysis

📊 Developer Tools

📚 Wiki System

🏆 Arena & Dev Rank

🔐 Enterprise Ready

🚀 Quick Start

Prerequisites

One-Command Setup

Configure GitHub OAuth

Start Development

📦 Tech Stack

🏗️ Architecture

🔧 Development

Project Structure

Available Scripts

Environment Variables

🤝 Contributing

How to Contribute

Development Guidelines

Areas We Need Help

📚 Documentation

🚀 Deployment

Deploy to Vercel (Recommended)

Manual Deployment

🗺️ Roadmap

Completed

In Progress

Future

📊 Stats

🙏 Acknowledgments

📄 License

🔗 Links

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors 5

Uh oh!

Languages

Packages