---

Why This Project

AI Codebase Navigator turns any GitHub repository into an interactive developer cockpit.

Instead of manually reading file-by-file, it helps you:

• Understand architecture quickly
• Explore structure visually
• Detect dependencies and risk zones
• Ask codebase-specific questions with AI
• Simulate change impact before editing

Built to solve: "How can developers safely understand and modify unfamiliar codebases faster?"

---

Feature Highlights

Feature	What it does
Analyze Repository	Ingests a GitHub URL and builds repository insights
Repository Map	Visualizes folder and module hierarchy
Dependency Explorer	Detects packages and versions quickly
AI Chat	Answers context-aware questions about analyzed code
Impact Analysis	Predicts blast radius for file/module/function changes
Bug Detector	Surfaces risky code paths and bug hotspots
Guided Codebase Tour	Walks through key modules for faster onboarding

---

Animated Flow

flowchart TD
	A[User enters GitHub repository URL]
	A --> B[Repository analysis pipeline]

	subgraph INGEST[Ingestion and Understanding]
		direction TB
		B --> C[Fetch metadata and repository tree]
		C --> D[Extract dependencies and structure]
		D --> E[Generate embeddings and index context]
	end

	subgraph INTEL[AI Intelligence Layer]
		direction TB
		E --> F[Context retrieval engine]
		F --> G[Repository-aware AI responses]
	end

	subgraph OUTPUT[Developer Outputs]
		direction LR
		G --> H[AI Chat]
		G --> I[Impact Analysis]
		G --> J[Bug Detector]
		G --> K[Repository Map]
		G --> L[Guided Tour]
	end

	classDef ingest fill:#0f172a,stroke:#2ec4b6,color:#e2e8f0,stroke-width:1px;
	classDef intel fill:#111827,stroke:#22d3ee,color:#e2e8f0,stroke-width:1px;
	classDef output fill:#0b132b,stroke:#14b8a6,color:#e2e8f0,stroke-width:1px;

	class B,C,D,E ingest;
	class F,G intel;
	class H,I,J,K,L output;

Loading

---

Tech Stack

Domain	Stack	Purpose
Frontend UI		Interactive, responsive, animated UX
Backend API		Auth, analysis, routing, and API orchestration
Data Layer		Persistence, caching, and fast retrieval
AI + Search		Context indexing, semantic retrieval, code-aware AI
Payments + Deploy		Subscription checkout and production hosting

---

Project Structure

ai-code-nav/
|- backend/   # APIs, auth, repository analysis, AI services
|- client/    # UI pages, components, interactions
|- README.md

---

Quick Start

1. Clone

git clone <YOUR_REPO_URL>
cd "ai code nav"

2. Backend

cd backend
npm install
npm run dev

3. Frontend

cd client
npm install
npm run dev

---

Environment Variables

Backend (.env)

• Database/cache: Supabase, Redis
• Auth/session: JWT secret, cookie secret
• OAuth: GitHub, Google
• AI providers: OpenRouter, embeddings
• Payment (optional): Stripe

Frontend (.env)

• VITE_API_URL
• VITE_GOOGLE_CLIENT_ID

---

Demo Sequence

1. Login with GitHub or Google
2. Analyze a repository URL
3. Show Repository Map
4. Ask AI Chat a repo-specific question
5. Run Impact Analysis on a target module
6. Show Bug Detector + dependencies + guided tour

---

Created By

ParthPipermintwala Pipermintwala Full-Stack + Product Engineering

Darshan Modi AI Logic + Developer Experience

Made with code, coffee, and hackathon pressure.