🚀 gh.gg

AI-Powered GitHub Repository Analysis & Developer Arena

Live Demo • Documentation • Report Bug • Request Feature

🎯 What is gh.gg?

gh.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

🤖 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

🏆 Dev Rank (Coming Soon)

ELO Rankings: Competitive developer rankings based on GitHub activity
Code Battles: Challenge other developers and showcase your skills
Tournaments: Participate in coding competitions
Achievements: Unlock badges and track your progress

🔐 Enterprise Ready

Unified Authentication System: 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) support
Stripe payment integration
PostgreSQL database with Drizzle ORM
Type-safe tRPC API

🚀 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: gh.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)
Language	TypeScript
Runtime	Bun
Database	PostgreSQL + Drizzle ORM
Authentication	Better Auth (OAuth) + GitHub App
API	tRPC
AI	Google Gemini via Vercel AI SDK
GitHub	Octokit
Styling	Tailwind CSS + shadcn/ui
Payments	Stripe
Email	Resend
Deployment	Vercel

🏗️ Architecture

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

🔧 Development

Project Structure

github.gg/
├── src/
│   ├── app/              # Next.js App Router pages
│   ├── components/       # React components
│   ├── lib/
│   │   ├── ai/          # AI analysis modules
│   │   ├── auth/        # Unified auth system (better-auth)
│   │   ├── github/      # GitHub API & App integration
│   │   └── trpc/        # tRPC routes and procedures
│   ├── db/              # Database schema and migrations
│   └── styles/          # Global styles
├── tests/               # Test files
├── docs/                # Documentation
└── drizzle/            # Database migrations

Available Scripts

See package.json for all available scripts. Common commands:

bun dev                  # Start development server
bun run db:start        # Start PostgreSQL with Docker
bun run db:studio       # Open Drizzle Studio
bun test                # Run tests

Environment Variables

See .env.example for all configuration options. The setup script automatically creates .env.local with development defaults.

🤝 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
Testing Guide: How to test PR review features
Activation Guide: Setting up the GitHub App
API Documentation: tRPC API reference

🚀 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

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

📊 Stats

🙏 Acknowledgments

Thanks to all contributors who have helped build gh.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 gh.gg community

Note: gh.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 569 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
README.md		README.md
bun.lock		bun.lock
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

🚀 gh.gg

🎯 What is gh.gg?

✨ Key Features

🤖 AI-Powered Analysis

📊 Developer Tools

🏆 Dev Rank (Coming Soon)

🔐 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

📊 Stats

🙏 Acknowledgments

📄 License

🔗 Links

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors 5

Uh oh!

Languages

Packages