Skip to content

Latest commit

Β 

History

51 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

SafePath Banner

πŸ›‘οΈ SafePath

Smart Emergency Response & Community Safety Platform

A modern full-stack MERN application that enables citizens, volunteers, and administrators to collaborate during emergencies through real-time reporting, volunteer management, live location services, and rescue tracking.

Built for HACKHAZARDS '26

React Node.js MongoDB JWT License Status


🌐 Live Demo

πŸš€ Production

https://safepath-hackhazard-project.onrender.com


πŸ“– Overview

SafePath is a community-driven emergency response platform designed to improve public safety by connecting citizens, volunteers, and emergency services on a single platform.

During emergencies, users can instantly report incidents, request help, discover nearby emergency services, and track rescue progress in real time.

The platform empowers verified volunteers and administrators to coordinate rescue operations efficiently while providing citizens with a simple and responsive interface.


πŸ† HackHazards 2026 Submission

Screenshot 2026-07-13 113447

🎯 Hackathon Theme

Infrastructure, Mobility & Smart Systems

This domain focuses on building software that improves large-scale physical and digital systems, including transportation, emergency response, smart city infrastructure, mobility solutions, IoT-enabled platforms, and real-time monitoring systems.

🌟 Theme Alignment

SafePath was developed as a solution under the Infrastructure, Mobility & Smart Systems theme.

The platform enhances emergency response by enabling citizens, volunteers, and administrators to coordinate efficiently through a centralized digital platform.

SafePath contributes to this theme by providing:

  • 🚨 Real-time emergency incident reporting
  • πŸ—ΊοΈ Live location and interactive mapping
  • πŸš‘ Nearby emergency service discovery
  • πŸ‘₯ Community volunteer coordination
  • πŸ“ Rescue assignment and tracking
  • πŸ₯ Smart emergency resource management
  • πŸ“Š Administrative dashboard for emergency monitoring
  • ⚑ Faster communication during critical situations

By integrating mapping technologies, secure authentication, and centralized emergency management, SafePath helps improve coordination between citizens, volunteers, and emergency responders, contributing to safer and smarter communities.

🚨 Problem Statement

Emergency response systems often suffer from:

  • Slow communication
  • Delayed emergency assistance
  • Lack of nearby volunteer coordination
  • Poor visibility of rescue progress
  • Limited access to emergency resources

These issues increase response time and reduce the effectiveness of emergency management.


πŸ’‘ Our Solution

SafePath bridges the gap between people in need and responders by providing:

  • Real-time emergency reporting
  • Secure authentication system
  • Community volunteer network
  • Live rescue status tracking
  • Nearby emergency services
  • Interactive maps
  • Centralized admin management

The platform ensures faster communication and more organized emergency coordination.


✨ Key Features

πŸ‘€ Authentication

  • Secure User Registration
  • JWT Authentication
  • Login & Logout
  • Protected Routes
  • Role-based Access Control

🚨 Emergency Management

  • Report Incidents
  • Emergency SOS
  • Incident Categories
  • Live Rescue Tracking
  • Report History

πŸ—ΊοΈ Smart Mapping

  • Interactive Leaflet Maps
  • Live User Location
  • Nearby Hospitals
  • Police Stations
  • Fire Stations
  • Pharmacies
  • Volunteers

πŸ‘₯ Volunteer System

  • Volunteer Registration
  • Volunteer Dashboard
  • Application Approval
  • Rescue Assignment
  • Rescue Status Updates

πŸ› οΈ Admin Dashboard

  • Admin Login
  • Dashboard Analytics
  • Volunteer Approval
  • Incident Management
  • Rescue Assignment
  • User Management

πŸ“± User Experience

  • Fully Responsive Design
  • Clean UI
  • Fast Navigation
  • Mobile Friendly
  • Modern Dashboard

πŸ›  Tech Stack

Frontend

  • React 19
  • Vite
  • React Router DOM
  • Axios
  • React Leaflet
  • Lucide React
  • CSS3

Backend

  • Node.js
  • Express.js
  • JWT Authentication
  • REST API

Database

  • MongoDB Atlas
  • Mongoose ODM

Deployment


πŸ—οΈ System Architecture

                    User
                      β”‚
                      β–Ό
           React + Vite Frontend
                      β”‚
              REST API Requests
                      β”‚
                      β–Ό
            Node.js + Express API
                      β”‚
            JWT Authentication
                      β”‚
                      β–Ό
             MongoDB Atlas Database

πŸ“‚ Project Structure

SafePath
β”‚
β”œβ”€β”€ backend
β”‚   β”œβ”€β”€ config
β”‚   β”œβ”€β”€ controllers
β”‚   β”œβ”€β”€ middleware
β”‚   β”œβ”€β”€ models
β”‚   β”œβ”€β”€ routes
β”‚   β”œβ”€β”€ utils
β”‚   β”œβ”€β”€ data
β”‚   └── server.js
β”‚
β”œβ”€β”€ frontend
β”‚   β”œβ”€β”€ public
β”‚   β”œβ”€β”€ src
β”‚   β”‚   β”œβ”€β”€ components
β”‚   β”‚   β”œβ”€β”€ pages
β”‚   β”‚   β”œβ”€β”€ assets
β”‚   β”‚   └── styles
β”‚   └── vite.config.js
β”‚
β”œβ”€β”€ README.md
└── LICENSE

πŸš€ Getting Started

Clone Repository

git clone https://github.com/Codewith-Yogita/SafePath_HACKHAZARD_PROJECT.git

Install Dependencies

Backend

cd backend
npm install

Frontend

cd frontend
npm install

Environment Variables

Create a .env file inside the backend folder.

PORT=5000

MONGODB_URI=Your_MongoDB_Atlas_URI

JWT_SECRET=Your_JWT_Secret

NODE_ENV=development

Run Backend

cd backend

npm run dev

Run Frontend

cd frontend

npm run dev

πŸ“Έ Application Screenshots

🏠 Landing Page

Screenshot 2026-07-13 111441

πŸ” Authentication

Screenshot 2026-07-13 111515 Screenshot 2026-07-13 111615

πŸ—ΊοΈ Interactive Map

Screenshot 2026-07-13 111715

🚨 Report Incident

Screenshot 2026-07-13 111748

πŸ‘₯ Volunteer Dashboard

Screenshot 2026-07-13 111829

πŸ›  Admin Dashboard

Screenshot 2026-07-13 111946

πŸ“ Rescue Status

Screenshot 2026-07-13 112127

πŸ”’ Security Features

  • JWT Authentication
  • Protected Routes
  • Role-based Authorization
  • Password Hashing (bcrypt)
  • MongoDB Validation
  • Secure REST APIs

πŸ“ˆ Future Enhancements

  • Live Socket.IO Notifications
  • Push Notifications
  • AI Incident Detection
  • Image-based Incident Verification
  • Route Optimization
  • Multi-language Support
  • Offline Emergency Mode
  • Government API Integration
  • Mobile Application
  • Emergency Chat System

πŸ‘¨β€πŸ’» Team HEXORA

Name Role
Yogita Sharma Team Lead & Full Stack Developer
Sawal Pushkarna Team Member
Priyanshi Team Member
Manpreet Dhir Team Member

πŸ† Hackathon

Event

HACKHAZARDS '26

Theme

Infrastructure, Mobility & Smart Systems

SafePath was developed to improve emergency response through technology, enabling communities to collaborate during emergencies using modern web technologies.


🀝 Contributing

Contributions are always welcome.

  1. Fork the repository

  2. Create your feature branch

git checkout -b feature-name
  1. Commit your changes
git commit -m "Added new feature"
  1. Push
git push origin feature-name
  1. Open a Pull Request

πŸ“„ License

Distributed under the MIT License.

See LICENSE for more information.


⭐ Support

If you found this project useful,

please consider giving it a ⭐ on GitHub.

It really helps!


Built with ❀️ by Team HEXORA

Together, making communities safer through technology.

About

SafePath is a full-stack MERN emergency response platform that enables real-time incident reporting, volunteer coordination, rescue tracking, and smart emergency resource management.

Topics

Resources

Stars

3 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages