Skip to main content

Find Optimal Bus Routes with Ease

A React-based route finding application that calculates optimal bus routes using intelligent pathfinding algorithms and Google Maps integration.

Get StartedExplore API
Real-time Route Calculation
Google Maps Integration
Walking Distance Optimization

Quick Start

Get the Route Finder up and running in minutes

1

Clone the Repository

Start by cloning the project repository to your local machine.
git clone https://github.com/JoelNuta/LaravelReact.git
cd LaravelReact
2

Install Dependencies

Install all required npm packages for both the frontend and backend.
npm install
This installs React, Express, Webpack, Babel, and other dependencies.
3

Configure Google Maps API

Add your Google Maps API key to the application. Edit public/index.html and replace the placeholder API key:
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY"></script>
4

Start the Application

Launch both the development server and webpack build process:
npm start
The application will be available at http://localhost:8080

Explore by Topic

Deep dive into specific areas of the Route Finder application

Architecture

Understand the system design, component structure, and data flow

Components

Explore React components including RouteForm, Map, and Result

Route Algorithm

Learn how the pathfinding algorithm calculates optimal routes

API Endpoints

Reference for /allRoutes and /route API endpoints

Configuration

Configure Webpack bundling and Google Maps integration

Installation Guide

Complete setup instructions and environment configuration

Key Features

Everything you need for intelligent route finding

Intelligent Pathfinding

Advanced algorithm that considers walking distance, bus connections, and transfer optimization to find the best route

Google Maps Integration

Visual route display with markers, directions, and interactive maps powered by Google Maps API

Real-time Calculation

Express backend processes route requests instantly, calculating optimal paths based on current location data

Modular Architecture

Clean component-based React architecture with separate client and server logic for easy maintenance

Ready to Build Your Own Route Finder?

Get started with our comprehensive documentation and explore how the intelligent pathfinding algorithm works under the hood.

Start BuildingLearn the Algorithm

Build docs developers (and LLMs) love

Get started for freeTalk to us