Skip to content
Tamil-networksPublic

About

A smart college bus tracking system using React Native, GPS, Google Maps, Node.js, Express, and MongoDB for real-time bus location tracking

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

ย 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸšŒ BusV8 โ€” Smart College Bus Tracking System

BusV8 is a smart college bus tracking system designed to help students discover and track their college buses in real time.

Instead of requiring a dedicated GPS tracking device to be installed on every college bus, BusV8 uses the smartphones of students/authorized users on the bus to share live location information.

The system combines a React Native mobile application, Node.js backend, MongoDB database, and Google Maps to provide real-time bus location and tracking.


๐Ÿ“ฑ Overview

Finding a college bus can be difficult when students do not know the current location of the bus or its expected arrival time.

Traditional bus tracking systems often require dedicated GPS hardware to be installed on every bus.

BusV8 provides an alternative approach: smartphones already available on the bus can be used to share the bus's live location.

This reduces the need for additional dedicated GPS tracking hardware.


๐ŸŽฏ Project Objective

The main objective of BusV8 is to provide a practical and cost-effective college bus tracking solution.

The system helps:

  • Students find their college bus
  • Students track the bus in real time
  • Students view bus locations on a map
  • Colleges manage buses and boarding points
  • Authorized users share live bus locations
  • Students identify the nearest/appropriate bus
  • Improve visibility of bus movement

โœจ Features

๐ŸšŒ Real-Time Bus Tracking

BusV8 displays the current bus location on Google Maps.

Authorized smartphones can continuously share location information while the bus is travelling.


๐Ÿ“ Live Location Sharing

The application can use the smartphone's location services to share the bus's current location.

The location can be tracked in the background so that the tracking process can continue while the application is not actively being viewed.


๐Ÿ—บ๏ธ Google Maps Integration

Google Maps is used to visualize:

  • Bus locations
  • Boarding points
  • Location markers
  • Bus movement

๐ŸŽ“ College Management

The system supports college-related bus management, including:

  • College registration
  • Bus registration
  • Bus management
  • Boarding-point management

๐Ÿ‘จโ€๐ŸŽ“ Student Interface

Students can use the application to:

  • Discover available buses
  • View live bus locations
  • View boarding points
  • Track their bus
  • Manage their profile
  • Manage account settings

๐Ÿš Driver / Bus Location Interface

Authorized users can provide the live location of the bus using their smartphone.

The system uses this location to update the bus position for students.


๐Ÿ” Authentication

BusV8 provides authentication functionality for authorized users.

The system includes:

  • User registration
  • Login
  • Authentication
  • Password reset
  • Account management
  • Automatic login

JWT is used for authentication.


๐Ÿ‘ค Profile & Settings

Users can manage their:

  • Profile
  • Account settings
  • Application preferences

๐Ÿง  How BusV8 Works

The basic workflow is:

        Student / Authorized User
                  โ”‚
                  โ–ผ
        โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
        โ”‚  React Native App   โ”‚
        โ”‚                     โ”‚
        โ”‚ GPS Location        โ”‚
        โ”‚ Bus Information     โ”‚
        โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                   โ”‚
                   โ”‚ Axios / API
                   โ–ผ
        โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
        โ”‚ Node.js + Express   โ”‚
        โ”‚       Backend       โ”‚
        โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                   โ”‚
                   โ–ผ
        โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
        โ”‚      MongoDB        โ”‚
        โ”‚                     โ”‚
        โ”‚ Users               โ”‚
        โ”‚ Buses               โ”‚
        โ”‚ Locations           โ”‚
        โ”‚ Boarding Points     โ”‚
        โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                   โ”‚
                   โ–ผ
        โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
        โ”‚    React Native     โ”‚
        โ”‚    Student App      โ”‚
        โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                   โ”‚
                   โ–ผ
        โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
        โ”‚    Google Maps      โ”‚
        โ”‚                     โ”‚
        โ”‚ Live Bus Location   โ”‚
        โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐Ÿ—๏ธ System Architecture

Smartphone GPS
      โ”‚
      โ–ผ
React Native + Expo
      โ”‚
      โ”‚ HTTP API
      โ–ผ
Node.js + Express.js
      โ”‚
      โ–ผ
MongoDB
      โ”‚
      โ”‚
      โ–ผ
React Native Client
      โ”‚
      โ–ผ
Google Maps
      โ”‚
      โ–ผ
Live Bus Location

๐Ÿ› ๏ธ Technologies Used

Mobile Application

  • React Native
  • Expo
  • JavaScript
  • Axios
  • AsyncStorage

Backend

  • Node.js
  • Express.js
  • JavaScript

Database

  • MongoDB

Maps & Location

  • Google Maps
  • Smartphone GPS / Location Services
  • Background Location Tracking

Authentication

  • JSON Web Token (JWT)

Development Tools

  • Visual Studio Code
  • Expo
  • Git
  • GitHub

๐Ÿ“‚ Project Structure

A typical project structure is:

busv8/
โ”‚
โ”œโ”€โ”€ mobile/
โ”‚   โ”œโ”€โ”€ assets/
โ”‚   โ”œโ”€โ”€ components/
โ”‚   โ”œโ”€โ”€ screens/
โ”‚   โ”œโ”€โ”€ services/
โ”‚   โ”œโ”€โ”€ navigation/
โ”‚   โ”œโ”€โ”€ utils/
โ”‚   โ”œโ”€โ”€ App.js
โ”‚   โ””โ”€โ”€ package.json
โ”‚
โ”œโ”€โ”€ backend/
โ”‚   โ”œโ”€โ”€ controllers/
โ”‚   โ”œโ”€โ”€ models/
โ”‚   โ”œโ”€โ”€ routes/
โ”‚   โ”œโ”€โ”€ middleware/
โ”‚   โ”œโ”€โ”€ services/
โ”‚   โ”œโ”€โ”€ server.js
โ”‚   โ””โ”€โ”€ package.json
โ”‚
โ”œโ”€โ”€ README.md
โ””โ”€โ”€ .gitignore

Update the structure above if your actual repository uses different folder names.


๐Ÿš€ Getting Started

Prerequisites

Install the following before running the project:

  • Node.js
  • npm
  • Expo
  • React Native development environment
  • Android Studio
  • Android SDK
  • MongoDB
  • Git

๐Ÿ“ฅ Clone the Repository

git clone YOUR_GITHUB_REPOSITORY_URL
cd busv8

๐Ÿ“ฑ Mobile Application Setup

Navigate to the mobile application directory:

cd mobile

Install dependencies:

npm install

Start Expo:

npx expo start

The application can then be tested using a compatible Android device/emulator.


๐Ÿ–ฅ๏ธ Backend Setup

Open another terminal and navigate to the backend:

cd backend

Install dependencies:

npm install

Configure your environment variables in .env.

Example:

PORT=5000
MONGODB_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret
GOOGLE_MAPS_API_KEY=your_google_maps_api_key

Never upload your actual .env file or secret credentials to GitHub.

Start the backend:

npm start

๐Ÿ“ Location Tracking Workflow

BusV8 uses smartphone location services to provide live bus tracking.

The workflow is:

Smartphone GPS
      โ†“
Current Latitude / Longitude
      โ†“
React Native Application
      โ†“
Backend API
      โ†“
MongoDB
      โ†“
Student Application
      โ†“
Google Maps
      โ†“
Live Bus Marker

This allows students to see the current location of the bus.


๐Ÿ” Authentication

BusV8 uses JWT-based authentication to protect authenticated functionality.

The authentication flow is:

User Login
    โ†“
Credentials Verified
    โ†“
JWT Generated
    โ†“
Token Stored
    โ†“
Authenticated API Requests

AsyncStorage is used on the mobile application for persistent client-side storage where required.


๐Ÿ—บ๏ธ Bus & Boarding Point Management

The system supports management of:

Buses

  • Bus registration
  • Bus information
  • Bus tracking
  • Bus location

Boarding Points

  • Boarding point registration
  • Boarding point information
  • Location information
  • Student access to boarding-point information

๐Ÿ“ธ Screenshots

Add screenshots of your actual application here.

Home / Bus List

![BusV8 Home](screenshots/home.png)

Live Bus Tracking

![Live Bus Tracking](screenshots/live-tracking.png)

Google Maps

![Bus Location Map](screenshots/map.png)

Login

![Login](screenshots/login.png)

Bus / Boarding Point

![Bus Details](screenshots/bus-details.png)

Recommended folder:

screenshots/
โ”œโ”€โ”€ home.png
โ”œโ”€โ”€ login.png
โ”œโ”€โ”€ live-tracking.png
โ”œโ”€โ”€ map.png
โ””โ”€โ”€ bus-details.png

๐Ÿ’ก Why BusV8?

Traditional bus tracking solutions may require a dedicated GPS tracking device for each bus.

BusV8 explores a different approach:

Traditional Approach

Bus
 โ†“
Dedicated GPS Device
 โ†“
Tracking Server
 โ†“
Student

BusV8 approach:

Bus
 โ†“
Student / Authorized Smartphone
 โ†“
GPS Location
 โ†“
BusV8 Server
 โ†“
Student Application

This can reduce the requirement for additional dedicated GPS hardware.


๐ŸŽฏ Key Benefits

  • Real-time bus visibility
  • Smartphone-based location sharing
  • Reduced dependency on dedicated GPS hardware
  • Google Maps integration
  • Student-focused interface
  • Centralized bus management
  • Boarding-point management
  • Secure authentication
  • Background location tracking

๐Ÿ”ฎ Future Improvements

Possible future improvements include:

  • Estimated Time of Arrival (ETA)
  • Route visualization
  • Push notifications
  • Bus arrival notifications
  • Geofencing
  • Multiple colleges
  • Advanced admin dashboard
  • Route history
  • Trip history
  • Driver verification
  • Improved location accuracy
  • Offline support
  • Analytics and reporting

๐Ÿ“Š Project Status

Completed โœ…

BusV8 is a completed smart college bus tracking project developed to provide real-time bus discovery and location tracking using smartphones and cloud-based software technologies.


๐Ÿ‘จโ€๐Ÿ’ป Developer

Tamilselvan

Software Developer


โญ Support

If you find this project interesting, consider giving the repository a โญ on GitHub.

About

A smart college bus tracking system using React Native, GPS, Google Maps, Node.js, Express, and MongoDB for real-time bus location tracking

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages