https://github.com/devansh-ds/crisisconnect

CrisisConnect – A full-stack Disaster Management PWA built with React.js, Redux, TailwindCSS (frontend) and Spring Boot, PostgreSQL (backend). Features include SOS requests, disaster zone monitoring, real-time safety tips, authentication with 2FA, OTP verification, and admin dashboards for crisis response.
https://github.com/devansh-ds/crisisconnect

2fa-security html html-css-javascript java leafletjs postgresql postman react react-redux react-router spring-boot spring-security-jwt

Last synced: 6 months ago
JSON representation

CrisisConnect – A full-stack Disaster Management PWA built with React.js, Redux, TailwindCSS (frontend) and Spring Boot, PostgreSQL (backend). Features include SOS requests, disaster zone monitoring, real-time safety tips, authentication with 2FA, OTP verification, and admin dashboards for crisis response.

• Host: GitHub
• URL: https://github.com/devansh-ds/crisisconnect
• Owner: Devansh-ds
• Created: 2025-09-06T11:06:10.000Z (7 months ago)
• Default Branch: main
• Last Pushed: 2025-09-23T18:16:31.000Z (6 months ago)
• Last Synced: 2025-09-23T20:21:38.006Z (6 months ago)
• Topics: 2fa-security, html, html-css-javascript, java, leafletjs, postgresql, postman, react, react-redux, react-router, spring-boot, spring-security-jwt
• Language: JavaScript
• Homepage:
• Size: 34.3 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: Readme.md

Awesome Lists containing this project

README

          
# 🚨 CrisisConnect

> A disaster relief management platform for real-time crisis response, zone monitoring, and citizen SOS requests.

![CrisisConnect Banner](./screenshots/photo-collage.png.png)

---

## 📖 Overview

CrisisConnect is a full-stack disaster management system built to connect citizens, NGOs, and government authorities during emergencies.

It enables **real-time SOS reporting**, **zone-based monitoring**, and **safety tips management**, with admin capabilities for managing disaster zones and resources.

---

## ⚙️ Tech Stack

- **Frontend:** React.js, Redux, TailwindCSS, Leaflet.js (for maps)

- **Backend:** Spring Boot, Spring Security, PostgreSQL

- **Auth Features:** JWT, OTP verification, Two-Factor Authentication, Reset Password

- **Other Tools:** Docker (for containerized deployment)

---

## ✨ Features

### 👥 Users

- Register/Login with secure authentication

- Enable 2FA and OTP verification

- Submit SOS requests with geolocation + disaster type

- View safety tips for disaster awareness

- Personal profile with editable details (name, phone, address)

- Track personal SOS history

### 🛠️ Admins

- Create, edit, and delete disaster zones

- Manage SOS requests (update statuses)

- Add and delete safety tips for different disaster types

- Monitor real-time SOS requests on the map

---

## 📸 Screenshots

### Dashboard & Analytics

![Dashboard Screenshot](screenshots/dashboard1.png)

![Dashboard Analytics and quick actions](screenshots/dashboardAnalytics.png)

![Dashboard map](screenshots/dashboardMap.png)

### Disaster Zones Management

![Disaster Zone page](screenshots/disasterZone.png)

![Add/Edit disaster Zone](screenshots/addEditZone.png)

### Detailed Disaster Zone

![Zone map containing sos locations](screenshots/detailedZone.png)

![Zone specific analytics](screenshots/detailedZoneAnalytics.png)

![Safety Tips of specific zone](screenshots/safetyTips.png)

### SOS Requests

![Sos page](screenshots/sosPage.png)

![All sos requests (or by filtering)](screenshots/sosRequests.png)

![SOS Analytics](screenshots/sosAnalytics.png)

![Sos By disaster types](screenshots/sosDisasterType.png)

![Create Sos](screenshots/createSos.png)

### Profile Page

![Profile page](screenshots/profilePage.png)

![Update personal details](screenshots/editProfile.png)

## 🚀 Local Setup

### Prerequisites

- Node.js (v18+)

- Java 17+

- PostgreSQL (running locally or via Docker)

### Frontend Setup

```bash

cd Frontend

npm install

npm run dev

```

### Backend Setup

```bash

cd Backend

./mvnw spring-boot:run

```

### Database

Create a PostgreSQL database and update your `application.yml` with credentials:

```yaml

spring:

  datasource:

    url: jdbc:postgresql://localhost:5432/crisisconnect

    username: postgres

    password: password

```

## Also set your email and its google password for the two-factor authentication endpoints.

## 🔐 Authentication Features

- JWT authentication

- Reset password flow

- OTP verification for sensitive actions

- Two-factor authentication support

---

## 📌 Roadmap

- Push notifications for new SOS requests

- Offline-first PWA support

- Role-based dashboards (Citizen vs NGO vs Admin)

---

## 🤝 Contribution

Contributions are welcome! Please open an issue or PR for improvements.

---