<div align="center">

🧠 RepoMind

Where Code Meets Clarity 💫🚀

<img src="./public/favicon.png" alt="RepoMind Logo" width="140" height="140" style="border-radius: 20px; margin: 20px 0;" />

Transform Your Codebase into Intelligent Documentation in Seconds

RepoMind is a sophisticated AI-powered ecosystem that autonomously analyzes, documents, and monitors your repository's health.

</div> <br/> <div align="center">

🎯 The Future of Codebase Intelligence

</div> <div align="center">

╔══════════════════════════════════════════════════════════════╗
║                                                              ║
║     🧠 Deep Code Analysis    •  🛡️ Robust Health Metrics    ║
║     💬 Semantic Code Chat    •  📂 Auto-Documentation       ║
║     📊 Activity Tracking     •  ⚡ Background Pipelines     ║
║                                                              ║
╚══════════════════════════════════════════════════════════════╝

</div> <br/>

🌈 Why RepoMind?

"Don't just write code — understand it."

RepoMind isn't just a documentation tool. It's your repository's digital twin, powered by RAG and LLMs to provide context-aware insights that manual documentation could never match.

💎 What Makes Us Different

<table> <tr> <td width="33%" align="center"> <img src="https://img.icons8.com/fluency/96/artificial-intelligence.png" width="60"/>

AI-Native

Powered by Gemini 2.0 Flash for lightning-fast architectural parsing and reasoning.

</td> <td width="33%" align="center"> <img src="https://img.icons8.com/fluency/96/shield.png" width="60"/>

Health-First

Instant health scores based on maintainability, documentation quality, and security.

</td> <td width="33%" align="center"> <img src="https://img.icons8.com/fluency/96/chat.png" width="60"/>

Context-Aware

RAG-powered chat using Pinecone ensures you're talking to your actual code, not generic LLMs.

</td> </tr> </table> <br/>

---

<div align="center">

🎨 Features That Fascinate

Every feature designed to make codebase management intelligent and effective

</div> <br/>

🏛️ Advanced Repository Management

<details open> <summary><b>Click to explore core engine features</b></summary> <br/>

| Feature | Description | Impact | |---------|-------------|--------| | 🤖 Codebase Parsing | High-fidelity extraction of system design | ⚡ 10x faster onboarding | | 🛡️ Health Analytics | Real-time "Health Score" across dimensions | 📈 Reduced tech debt | | 💬 Semantic Chat | Natural language queries via performant RAG | 💎 Instant insights | | 📊 Activity Stream | Continuous monitoring of repository changes | 🌍 Total visibility |

</details> <br/>

🧠 Intelligent Analysis Arsenal

<table> <tr> <td width="50%">

🛡️ Codebase Health Scoring

✓ Maintainability Analysis
✓ Documentation Coverage
✓ Security Vulnerability Check
✓ Structural Integrity Audit
✓ Test Coverage Metrics

A comprehensive radar chart of your repository's quality, updated with every analysis.

</td> <td width="50%">

💬 Ask RepoMind (RAG)

✓ Natural Language Interface
✓ Pinecone Vector Search
✓ Context-Aware Reasoning
✓ Implementation Strategies
✓ Bug Hunting Assistant

Chat directly with your codebase. No more manual searching through files.

</td> </tr> <tr> <td width="50%">

📂 Automated Documentation

✓ System Architecture Maps
✓ API Explorer (Auto-discovered)
✓ Component Library Deep-dive
✓ Dependency Relationship Mapping
✓ Markdown Export Support

Professional-grade documentation generated in seconds, not weeks.

</td> <td width="50%">

⚡ Background Pipeline

✓ Powered by Inngest
✓ Robust Asynchronous Analysis
✓ Horizontal Scalability
✓ Retriable Job Queues
✓ Real-time Progress Tracking

Heavy-duty processing that stays out of your way while providing deep insights.

</td> </tr> </table> <br/>

💫 Experience Excellence

<div align="center">

| 🎨 Design | 🚀 Performance | 🔒 Security | |-----------|----------------|-------------| | Sleek Dark Mode UI | Next.js 15 App Router | Better-Auth Integration | | Framer Motion Animations | Drizzle ORM Type-Safety | Encrypted Connection Strings | | Responsive Dashboard | Edge-ready Serverless | Role-based Access Control | | Interactive Diagrams | Bun-optimized Build | Secure API Gateway |

</div> <br/>

---

<div align="center">

🛠️ Tech Stack That Powers Innovation

Built with bleeding-edge technologies for maximum precision

</div> <br/> <table align="center"> <tr> <td width="50%" valign="top">

⚡ Frontend Excellence

┌─────────────────────────────────┐
│  🎯 Framework & Core            │
├─────────────────────────────────┤
│  Next.js 15        │ App Router │
│  React 19          │ Server RSC │
│  TypeScript 5      │ Type Safe  │
└─────────────────────────────────┘

┌─────────────────────────────────┐
│  🎨 UI & Styling                │
├─────────────────────────────────┤
│  Tailwind CSS 4    │ Modern CSS │
│  Shadcn UI         │ Components │
│  Framer Motion     │ Animations │
│  Lucide Icons      │ Visuals    │
└─────────────────────────────────┘

Why This Stack?

• 🚀 Blazing fast page loads
• 🎨 Premium dark-mode aesthetics
• 📱 Perfectly responsive layouts

</td> <td width="50%" valign="top">

💪 Backend Power

┌─────────────────────────────────┐
│  🗄️ Database & Vector           │
├─────────────────────────────────┤
│  PostgreSQL        │ Neon Cloud │
│  Drizzle ORM       │ Type-safe  │
│  Pinecone          │ Vector DB  │
└─────────────────────────────────┘

┌─────────────────────────────────┐
│  🤖 AI & Orchestration          │
├─────────────────────────────────┤
│  Gemini 2.0 Flash  │ LLM Engine │
│  Inngest           │ Workflows  │
│  Better-Auth       │ Security   │
│  Puter AI          │ Providers  │
└─────────────────────────────────┘

Why This Stack?

• 🧠 SOTA AI Reasoning
• ⚡ Event-driven architecture
• 🔒 Enterprise-grade security

</td> </tr> </table>

---

🚀 Installation

Prerequisites

• Node.js 20+ (Bun recommended)
• PostgreSQL Database (Neon)
• Pinecone API Key
• Gemini API Key / Puter Token

Quick Start

1. Clone the repository

git clone https://github.com/Vivek-736/RepoMind.git
cd repo-mind

2. Install dependencies

npm install # or bun install

3. Environment Setup

# Create .env file
cp .env.example .env

# Configure keys
DATABASE_URL=your_postgres_url
NEXT_PUBLIC_APP_URL=http://localhost:3000
PUTER_AUTH_TOKEN=your_token
GEMINI_API_KEY=your_key
PINECONE_API_KEY=your_key
GITHUB_CLIENT_ID=...
GITHUB_CLIENT_SECRET=...

4. Database Push

npx drizzle-kit push

5. Start Servers

# App
npm run dev

# Inngest (New terminal)
npx inngest-cli@latest dev

---

🎯 Usage Guide

Analyzing a Repo

1. Connect your GitHub account via the Dashboard.
2. Select a repository or paste a public URL.
3. Watch the Inngest pipeline trigger the AI analysis.
4. Explore the generated architecture and documentation.

Interacting with Code

1. Navigate to the Chat tab in any analyzed repo.
2. Ask questions like: "How does the authentication flow work?" or "Where is the database schema defined?".
3. Use the Health tab to identify technical debt hotspots.

---

🧑‍💻 Meet The Developer

<div align="center">

💜 Built with Passion by Vivek

Built for the future of engineering.

</div>