GitHub Analyzer

A Next.js application that analyzes GitHub repositories and presents AI-powered insights, architecture visualizations, and project health metrics through a modern dashboard.

Features • Getting Started • Documentation • Contributing • Community

---

📸 Screenshots

AI-Powered Repository Analysis Dashboard

View More Screenshots

Detailed Analytics and Insights


Repository Analysis Interface

---

✨ Features

• 🤖 AI-Powered Insights - Comprehensive dashboard with Overview, Team, Business, and Recommendations tabs
• 🏗️ Architecture Visualization - Mermaid-based diagrams and dependency mapping
• 🔐 GitHub OAuth - Secure authentication using NextAuth and Prisma
• 💾 PostgreSQL Database - Persistent storage via Prisma ORM
• 🎨 Modern UI - Beautiful interface with Tailwind CSS and Radix UI
• 📊 Analytics Dashboard - Contribution heatmaps, streak tracking, and activity metrics
• 🔄 Graceful Fallback - Works with sample data when AI key is not configured

---

🛠️ Tech Stack

Category	Technologies
Framework	Next.js 15 (App Router)
Language	TypeScript 5.x
UI/Styling	Tailwind CSS, Radix UI, Lucide Icons
Authentication	NextAuth.js with GitHub Provider
Database	PostgreSQL, Prisma ORM
Visualization	Chart.js, D3.js, Mermaid
AI	Google Generative AI (Gemini) - Optional

---

🚀 Getting Started

Prerequisites

• Node.js 18.18+ (recommended 20+)
• npm 9+ or pnpm/yarn
• PostgreSQL 13+
• GitHub OAuth App (Client ID and Secret)

Installation & Setup

1. Clone the repository

   git clone https://github.com/Jeelislive/Github-Analyzer.git
   cd Github-Analyzer

2. Install dependencies

   npm install

3. Set up environment variables

   Create a .env.local file in the project root:

   # Database
   DATABASE_URL="postgresql://username:password@localhost:5432/github_analyzer"
   
   # NextAuth
   NEXTAUTH_URL="http://localhost:3000"
   NEXTAUTH_SECRET="your-strong-random-secret"
   
   # GitHub OAuth (required)
   GITHUB_ID="your-github-client-id"
   GITHUB_SECRET="your-github-client-secret"
   
   # Gemini AI (optional)
   GEMINI_API_KEY="your-gemini-api-key"

4. Configure GitHub OAuth

   Create a GitHub OAuth App at GitHub Developer Settings:

   • Homepage URL: http://localhost:3000
   • Authorization callback URL: http://localhost:3000/api/auth/callback/github

   Copy the Client ID and Secret to your .env.local file.

5. Set up the database

   npx prisma generate
   npx prisma migrate dev

6. Run the development server

   npm run dev

7. Open your browser

   Navigate to http://localhost:3000 🎉

---

📖 How It Works

1. Authentication - Sign in with GitHub using NextAuth (configured in src/lib/auth.ts)
2. Repository Input - Enter any GitHub repository URL on the homepage
3. AI Analysis - The system analyzes code structure, dependencies, and metrics
4. Visualization - View insights through an interactive dashboard with multiple tabs:
   • Overview: Health scores, metrics, technologies, and project purpose
   • Team Insights: Activity and collaboration patterns
   • Business: Value and risk analysis
   • Recommendations: Automated improvement suggestions

Note: If GEMINI_API_KEY is not configured, the app uses fallback data to maintain functionality.

---

📂 Project Structure

Github-Analyzer/
├── src/
│   ├── app/                    # Next.js App Router pages & API routes
│   ├── components/
│   │   ├── ui/                 # Reusable UI components
│   │   ├── dashboard/          # Dashboard-specific components
│   │   └── sections/           # Landing page sections
│   └── lib/
│       ├── auth.ts             # NextAuth configuration
│       └── prisma.ts           # Prisma client
├── prisma/
│   ├── schema.prisma           # Database schema
│   └── migrations/             # Database migrations
├── public/                     # Static assets & icons
└── README.md

---

🔧 Available Scripts

Command	Description
npm run dev	Start development server with Turbopack
npm run build	Build the application for production
npm start	Start the production server
npm run lint	Run ESLint checks

---

❓ Troubleshooting

Authentication callback error

Verify that your GitHub OAuth app callback URL matches http://localhost:3000/api/auth/callback/github and that GITHUB_ID and GITHUB_SECRET are correctly set in .env.local.

Database connection issues

Check that your DATABASE_URL is correct and PostgreSQL is running. Run npx prisma migrate dev to apply migrations.

Missing AI insights

The app works without GEMINI_API_KEY using fallback data. To enable AI features, get an API key from Google AI Studio.

Build or type errors

Run npm run lint and ensure you're using Node.js 18.18+. Try reinstalling dependencies with npm install.

---

🤝 Contributing

We welcome contributions from the community! Here's how you can help:

Ways to Contribute

• 🐛 Report Bugs - Use our issue templates
• ✨ Suggest Features - Share your ideas for improvements
• 📝 Improve Documentation - Help make our docs better
• 🔧 Submit Pull Requests - Fix bugs or add new features

Development Workflow

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Run npm run lint to ensure code quality
5. Commit your changes (git commit -m 'Add amazing feature')
6. Push to your branch (git push origin feature/amazing-feature)
7. Open a Pull Request

Guidelines

• Keep PRs focused on a single feature or fix
• Add tests or sample data where applicable
• Update relevant documentation
• Ensure npm run lint passes before submitting
• For major changes (auth, database schema, analysis pipeline), include a migration plan

---

👥 Community

Join Our Open Source Community! 🌟

We believe in the power of open source and collaborative development. This project thrives because of amazing contributors like you!

🎉 Thanks to All Contributors

Made with ❤️ by developers, for developers

⭐ Star this repo • 🐛 Report Bug • 💡 Request Feature

---

🔒 Security

• 🚫 Never commit .env* files or secrets to version control
• 🔄 Rotate OAuth credentials immediately if exposed
• 🔐 Use a strong, randomly generated NEXTAUTH_SECRET in production
• 📋 Review the Security Policy for reporting vulnerabilities

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🙏 Acknowledgements

This project is built with amazing open-source technologies:

• Next.js - React framework for production
• NextAuth.js - Authentication for Next.js
• Prisma - Next-generation ORM
• Tailwind CSS - Utility-first CSS framework
• Radix UI - Unstyled, accessible components
• Chart.js - Simple yet flexible charting
• D3.js - Data visualization library
• Mermaid - Diagram and flowchart generation
• Google Generative AI - Gemini AI SDK

---

Built with 💙 by the open-source community

If you find this project helpful, consider giving it a ⭐!