GitIntel Documentation

A comprehensive platform for analyzing GitHub repositories, discovering beginner-friendly issues, and understanding open source trends

Features Overview

Beginner-Friendly Issues

  • • Automatically detects "good first issue" labeled issues
  • • Supports 19+ beginner-friendly label variations
  • • Direct GitHub integration with issue links

Repository Analytics

  • • Deep repository statistics and metrics
  • • Technology stack analysis
  • • Risk assessment and health scoring
  • • Real-time data from GitHub API
  • • Comprehensive search and discovery

Contributor Insights

  • • Detailed contributor analysis
  • • Commit history and activity tracking
  • • Active vs. inactive contributor identification
  • • Weekly contribution patterns
  • • Top contributor rankings

Growth & Trends

  • • Historical growth visualization
  • • Trending repositories by technology
  • • Competitive analysis and positioning
  • • Growth trend calculations
  • • Market insights and comparisons

Using Beginner-Friendly Issues

How It Works

GitIntel automatically scans repository issues for beginner-friendly labels and presents them in an easy-to-browse interface.

Supported Label Keywords:

• good first issue• beginner• help wanted• starter• easy• first-timer• up-for-grabs• new contributor• entry level

Accessing Beginner Issues

  1. Navigate to any repository's analytics page
  2. Look for the "Beginner Issues" button in the repository header
  3. Click to open the responsive drawer from the right side
  4. Browse issues with full context including labels and creation dates
  5. Click "View on GitHub" to open issues directly

Tech Stack

Frontend

  • Next.js 15 with App Router
  • TypeScript for type safety
  • Tailwind CSS for styling
  • shadcn/ui component library
  • Recharts for data visualization

APIs & Integration

  • GitHub GraphQL API
  • GitHub REST API (Octokit)
  • Real-time data fetching
  • Robust error handling
  • Request timeout management

Quick Setup

1. Clone and Install

git clone https://github.com/kunal-511/gitintel
cd gitintel
pnpm install

2. Set up Environment

Create a .env.local file with your GitHub token:

GITHUB_TOKEN=your_github_personal_access_token_here
NEXT_PUBLIC_APP_NAME=GitIntel

3. Start Development Server

pnpm dev

Open http://localhost:3000 to view the app

Contributing

This is a passion project, and I welcome any contributions! Feel free to open issues or submit pull requests on GitHub.