🗺️ MANAV

3D Campus Navigation System for IIT Mandi

MANAV is a next-generation interactive 3D campus navigation platform developed exclusively for IIT Mandi. It allows students, faculty, and visitors to explore the sprawling campus seamlessly with real-time route visualization and shortest-path calculation powered by advanced Graph Algorithms.

---

⚡ Key Features

Feature	Description
🌍 3D Visualization	Fully interactive 3D models of the IIT Mandi campus rendered in real-time directly in the browser using Three.js.
📍 Intelligent Routing	Calculates the absolute shortest physical path between any two campus buildings using Dijkstra's Algorithm.
🚀 Dynamic Rendering	Animates the optimal route seamlessly onto the 3D canvas, providing crystal-clear navigation instructions.
📱 Responsive UI	A sleek, glassmorphic React interface that works perfectly on both desktop computers and mobile devices.

---

🧠 Core Architecture & Algorithms

What makes MANAV powerful isn't just the 3D graphics—it's the underlying data structures.

The entire campus road network is mathematically modeled as a Weighted Graph. Every intersection is a Node, and every pathway is an Edge weighted by physical distance.

When a user requests a route:

1. The React Interface captures the start and destination nodes.
2. The core Dijkstra Engine executes over the Graph data structure, traversing thousands of potential pathways to guarantee the mathematically shortest route O(V^2).
3. The resulting path array is passed to the Three.js Engine, which interpolates points and dynamically draws a glowing trail across the 3D environment.

---

💻 Tech Stack

• Frontend Framework: React.js
• 3D Rendering Engine: Three.js / WebGL
• Core Languages: JavaScript, HTML5, CSS3
• Routing Algorithm: Dijkstra's Shortest Path

---

🚀 Quick Start

Want to run the 3D campus locally? Follow these steps:

# 1. Clone the repository
git clone https://github.com/Aditya-mittal21/Manav.git

# 2. Navigate into the project directory
cd Manav

# 3. Install NPM dependencies
npm install

# 4. Start the development server
npm start

The 3D campus will now be running on http://localhost:3000.

---

📂 Project Structure

src/
 ├── components/       # Reusable React UI elements (Sidebars, Menus)
 ├── assets/           # 3D Models (.gltf / .obj), textures, and map data
 ├── pages/            # Core views (MapViewer, About, Home)
 ├── routes/           # Graph data structures and Dijkstra implementation
 ├── App.js            # Main React layout and state wrapper
 └── index.js          # React DOM entry point

---

Developed by Aditya Mittal for IIT Mandi.