🌟 SAVIOUR - Disaster Management Platform

Empowering communities to prepare, respond, and recover from disasters

🚀 Overview

SAVIOUR is a cutting-edge disaster management platform built to save lives and strengthen community resilience during emergencies. Leveraging modern mobile technologies, our application delivers:

• ⚡ Real-time emergency coordination
• 🔔 Instant alerts and notifications
• 📍 Location-based resource tracking
• 👥 Community support networks
• 📊 Resource management tools
• 🛡️ Comprehensive safety information
• 📱 Available on iOS and Android platforms

✨ Key Features

🚨 Emergency Alert System

Expand for details

• Real-time SOS alerts with location tracking
• Multi-level emergency categorization (High/Medium/Low priority)
• Support for various emergency types (Medical, Fire, Natural Disasters, etc.)
• Image upload capability for emergency documentation
• 5-second cancellation window for accidental alerts

🗺️ Navigation & Location Services

Expand for details

• Fast location detection with caching for immediate response
• Fallback mechanisms for geolocation services
• Integration with OpenWeatherMap for local weather alerts
• Map visualization of nearby emergencies and resources

📊 Resource Management

Expand for details

• Track essential supplies in your area
• Request and offer resources during emergencies
• Inventory management for disaster response teams
• Base64 storage for images and documents

👥 Community Support

Expand for details

• User-to-user assistance network
• Community chat for local coordination
• Help tracking for emergency responders
• SOS response coordination

📱 User & Admin Dashboards

Expand for details

• User-friendly dashboards with real-time updates
• Admin controls for resource allocation and emergency management
• Safety statistics and activity tracking
• Quick action buttons for common emergency tasks

🛡️ Safety Information

Expand for details

• Comprehensive safety guidelines for different emergencies
• Video tutorials for first aid and safety procedures
• Interactive safety guide for various disaster scenarios
• Educational resources on disaster preparedness

💻 Technical Stack

Frontend	Backend	Mobile Features
React Native 0.79.5 Expo SDK 53.0.12 Native Base Components React Context API React Native Maps Reanimated Animations	Firebase Firestore Firebase Authentication Firebase Cloud Messaging Expo Notifications OpenWeatherMap API	File-based Routing Push Notifications Location Services Haptic Feedback Media Playback Offline Support

📂 Project Structure

saviour-mobile/
├── app/                     # Main application screens using file-based routing
│   ├── (auth)/              # Authentication screens (login, signup, forgot-password)
│   ├── (tabs)/              # Main tab (User) navigation screens
│   ├── Admin/               # Administrator-specific screens
│   └── Employee/            # Employee-specific screens
├── assets/                  # Images, fonts, videos, and sounds
│   ├── fonts/               # Custom fonts
│   ├── images/              # App images and icons
│   ├── safety-videos/       # Safety tutorial videos
│   └── sounds/              # Alert and notification sounds
├── components/              # Reusable UI components
│   ├── Chat/                # Chat-related components
│   ├── Map/                 # Map visualization components
│   ├── Modals/              # Modal dialogs
│   ├── Safety/              # Safety information components
│   └── ui/                  # Base UI components
├── constants/               # Theme configurations and color schemes
├── context/                 # React Context providers (Auth, Theme)
├── hooks/                   # Custom React hooks
└── lib/                     # Utility functions and configurations

� Getting Started

Prerequisites

• Node.js (v18 or newer)
• npm or yarn
• Expo CLI
• iOS Simulator (for iOS) or Android Emulator (for Android)
• Firebase account

📱 Installation Steps

1. Clone the repository:

git clone https://github.com/vikrantwiz02/Saviour.git
cd Saviour

2. Install dependencies:

npm install

3. Set up Firebase configuration:

   • Create a Firebase project
   • Add iOS and Android apps to your Firebase project
   • Configure the Firebase credentials in /lib/firebase.ts

4. Start the development server:

npx expo start

5. Run on specific platform:

# For iOS
npx expo start
press i or scan the QR from Expo Go app

# For Android
npx expo start
press a or scan the QR from Expo Go app

⚡ Performance Optimizations

🚀 Location caching	⚡ Optimized Firebase queries	📱 Progressive loading
Speeds up emergency responses	Faster data retrieval	Optimized UI components
📍 Geolocation fallbacks	🖼️ Expo Image optimization	🌐 Offline capability
Multiple location sources	Efficient image handling	Core features work without internet

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgements

✨ Team & Contributors

Project Leads

Vikrant Kumar Project Lead Email

Gunti Ravi Kumar LinkedIn

Harsh Kumar Palas LinkedIn

Anchal Siddharth Patil LinkedIn

_{Built with ❤️ by the SAVIOUR team}