Skip to main content

Real-Time Route Planning for SUST Students

MND combines university bus schedules with local transport options to find the optimal route from any location in Sylhet to campus. Never miss the bus again.

Get StartedExplore API Reference
From
Tilagor
To
SUST Campus
Fastest RouteBus 1 • 45 min
CostFree

Get Started in Minutes

Follow these steps to start planning your routes with MND

1

Choose Your Platform

MND is available as a Flutter mobile app for Android/iOS and a React web application. Pick the platform that works best for you.
git clone https://github.com/ihfaz297/MND.git
cd MND/mnd_flutter
flutter pub get
2

Configure API Connection

Set up your environment variables to connect to the MND backend API. Create a .env file with your backend URL.
.env
API_BASE_URL=http://localhost:3000
GOOGLE_MAPS_API_KEY=your_api_key_here
Get your Google Maps API key from the Google Cloud Console. You’ll need to enable the Directions API and Distance Matrix API.
3

Start the Application

Launch the app and start planning your routes. Select your origin and destination from the 19 available locations across Sylhet.
Flutter
flutter run
React Web
npm run dev
The backend automatically calculates the fastest routes combining bus schedules with CNG/rickshaw and walking options.
4

Plan Your First Route

Make your first API request to plan a route from any location to campus:
cURL
curl "http://localhost:3000/api/routes?from=TILAGOR&to=CAMPUS&time=08:00"

{
  "from": "TILAGOR",
  "to": "CAMPUS",
  "requestTime": "08:00",
  "options": [
    {
      "label": "Bus 1 Direct",
      "category": "fastest",
      "type": "direct",
      "transfers": 0,
      "totalTimeMin": 45,
      "totalCost": 0,
      "legs": [
        {
          "mode": "bus",
          "route_id": "bus1",
          "from": "TILAGOR",
          "to": "CAMPUS",
          "departure": "08:25",
          "arrival": "09:10",
          "durationMin": 45,
          "cost": 0
        }
      ]
    }
  ]
}

Key Features

Everything you need to navigate Sylhet and reach SUST campus on time

Multimodal Route Planning

Combines university buses with CNG, rickshaw, and walking to find the optimal route. Smart transfer detection between different transport modes.

Real-Time Schedules

Access live schedules for all 7 university bus routes. See departure times, stops, and availability in real-time.

Graph-Based Routing

Powered by Dijkstra’s shortest path algorithm on a weighted graph of 19 locations connected by 289 edges.

Save Favorites

Save your frequently used routes for quick access. Perfect for daily commutes from home to campus.

Google Maps Integration

Visualize your routes on an interactive map with color-coded polylines for different transport modes.

RESTful API

Clean REST API for developers. Build custom integrations and applications on top of MND’s routing engine.

Explore by Topic

Deep dive into specific areas of the platform

System Architecture

Understand how MND’s Node.js backend, Flutter mobile app, and React web frontend work together to deliver real-time route planning.

Learn more

API Reference

Complete API documentation for all 11 endpoints including route planning, bus schedules, favorites, and authentication.

Explore API

Mobile App

Build and deploy the Flutter mobile application for Android and iOS with Google Maps integration and offline caching.

View guide

Deployment

Deploy the backend API server, configure environment variables, and set up Google Cloud APIs for production use.

Get started

Ready to Start Building?

Explore the full documentation and start integrating MND’s route planning capabilities into your application today.

Get Started NowView on GitHub