Skip to content

vishalkishore/PathFinder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PathFinder: Visual Journey Through Shortest Paths 🛣️

License: MIT Docker C++ React

PathPilot is a powerful shortest path visualization toolkit featuring a C++ backend for efficient pathfinding algorithms and a React frontend for smooth, interactive visualizations. The project consists of two independent docker-containerized applications: GridGuide and StreetSage.

PathPilot Demo

🎯 Projects

1. GridGuide

An interactive Dijkstra's algorithm visualizer with a performant C++ backend and responsive React frontend.

GridGuide Demo

Key Features:

  • High-performance C++ implementation of Dijkstra's algorithm
  • Real-time visualization using React
  • Interactive node placement and wall creation
  • Microsecond-level path computation
  • WebSocket-based communication between frontend and backend

Watch GridGuide Demo Video

2. StreetSage

A real-world pathfinding implementation using OpenStreetMap data, powered by C++ routing engine.

StreetSage Screenshot

Key Features:

  • OpenStreetMap integration
  • C++ routing engine for lightning-fast calculations
  • React-based interactive map interface
  • Real-time routing updates
  • Custom waypoint system

Watch StreetSage Demo Video

🚀 Prerequisites

  • Docker >= 20.10.0
  • Docker Compose >= 2.0.0

That's it! Everything else is containerized.

🛠️ Quick Start

1. Clone the repository

git clone https://github.com/vishalkishore/PathFinder
cd PathPilot

2. Start GridGuide

cd GridGuide
docker compose up

Access the application at http://localhost

3. Start StreetSage

cd StreetSage
docker compose up

Access the application at http://localhost:5173

🔧 Development Setup

Running in Development Mode

GridGuide:

cd GridGuide
docker compose up --build

StreetSage:

cd StreetSage
docker compose up --build

🏗️ Build and Deployment

Production Build

# Build and run GridGuide
cd GridGuide
docker compose up --build

# Build and run StreetSage
cd StreetSage
docker compose up --build

Performance Optimization

  • C++ backend is compiled with -O3 optimization
  • React frontend is bundled with production optimizations
  • Docker images are multi-stage builds for minimal size

🤝 Contributing

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

🐛 Common Issues & Solutions

  1. Docker Build Errors
    # Clean docker cache
    docker system prune -a
    # Rebuild with no cache
    docker compose build --no-cache

📜 License

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

🙏 Acknowledgments


⭐️ If you found this project helpful, please consider giving it a star!

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published