Understand any codebase, instantly.

Repo360 is an AI-powered repository analyzer that transforms overwhelming codebases into clear, digestible insights. Simply paste a GitHub URL and get instant architectural breakdowns, file explanations, and guided exploration paths.

Demo Video - https://youtu.be/LAD-kBDGYUk

Inspired by GitDiagram by Ahmed - Another great tool for visualizing Git repositories!

The Problem: Joining a new project or exploring open-source repositories can be overwhelming. Developers spend hours just figuring out where to start, what each file does, and how components connect.

The Solution: Repo360 uses AI to instantly analyze repositories and provide:

• 📊 Architecture Overview: Visual component diagrams showing how your app is structured
• 🎯 Smart Entry Points: AI-prioritized list of files to read first
• 📝 File Explanations: Natural language descriptions of what each file does
• 🔍 Interactive Exploration: Click-to-explore interface with direct GitHub links
• 🎨 Visual Project Gallery: Screenshots and demos from README files

1. Enter a GitHub URL - Any public repository
2. Click "Analyze Repository" - AI processes the codebase
3. Explore the Results:
   • 📊 Executive Summary: Purpose, tech stack, setup instructions
   • 🏗️ Architecture Diagram: Visual component breakdown
   • 📁 File Explorer: Prioritized reading list with AI explanations
   • 🖼️ Project Gallery: Screenshots and demos
   • 🔧 Tools: Environment scanner, file classifier

• Next.js 15 - React framework with App Router
• TypeScript - Type-safe development
• Tailwind CSS - Utility-first styling
• Framer Motion - Smooth animations and interactions
• Radix UI - Accessible component primitives
• React Hook Form + Zod - Form handling and validation

• Google Gemini AI - Advanced language model for code analysis
• Firebase Genkit - AI development framework
• GitHub API (@octokit/rest) - Repository data fetching

• Lucide React - Beautiful icons
• Custom Gaming Theme - Vibrant colors and smooth animations
• Space Grotesk & Orbitron - Modern typography
• Dark/Light Mode - Full theme support

graph LR
    A[GitHub URL] --> B[Fetch Repository Data]
    B --> C[AI Analysis Engine]
    C --> D[Repository Summary]
    C --> E[Architecture Analysis]
    C --> F[File Classification]
    C --> G[Entry Point Suggestions]
    D --> H[Interactive Dashboard]
    E --> H
    F --> H
    G --> H

1. Repository Fetching: Securely fetch repository metadata, file structure, and key files
2. AI Processing: Multiple specialized AI agents analyze different aspects:
   • Summarizer: Creates executive summary with purpose, tech stack, and setup
   • Architect: Identifies components (frontend, backend, API, database) and their relationships
   • File Classifier: Categorizes files by importance and purpose
   • Entry Point Finder: Suggests optimal reading order for understanding the codebase
3. Visual Presentation: Transform analysis into interactive, explorable interface
4. GitHub Integration: Provide direct links to source files using correct repository branch

• Node.js 18+ and pnpm (or npm/yarn)
• GitHub Personal Access Token (optional, for higher rate limits)
• Google AI API Key (for Gemini AI)

1. Clone the repository

   git clone https://github.com/gurkiratz/Repo360.git
   cd Repo360

2. Install dependencies

   pnpm install

3. Environment setup

   cp .env.example .env.local

   Add your API keys:

   # Required: Google AI API Key
   GOOGLE_GENAI_API_KEY=your_google_ai_api_key_here
   
   # Optional: GitHub Token (increases rate limits)
   GITHUB_TOKEN=your_github_token_here

4. Start development server

   pnpm dev

5. Open your browser Navigate to http://localhost:9002

1. Visit Google AI Studio
2. Create a new API key
3. Add it to your .env.local as GOOGLE_GENAI_API_KEY

1. Go to GitHub Settings > Developer settings > Personal access tokens
2. Generate a new classic token with public_repo scope
3. Add it to your .env.local as GITHUB_TOKEN

Deploy easily on Vercel, Netlify, or any platform supporting Next.js:

pnpm build
pnpm start

We welcome contributions! Please see our Contributing Guide for details.

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

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