Ethiopia Earthquake Monitor 🌍

A sophisticated real-time earthquake monitoring and analysis platform specifically designed for Ethiopia. This application leverages advanced technologies to provide comprehensive seismic activity tracking, risk assessment, and educational resources for earthquake preparedness.

🌟 Key Features

Real-time Monitoring & Analysis

• Live Data Integration: Direct connection with USGS API for real-time earthquake data
• Interactive Mapping: Dynamic visualization using Leaflet with custom markers and risk zones
• Risk Heatmap: Regional risk assessment with detailed geological information
• Advanced Prediction Model: Sophisticated seismic activity prediction using:
  • Temporal clustering analysis
  • Magnitude trend evaluation
  • Frequency pattern recognition
  • Risk probability calculations

Trends, Search & Personalized Alerts

• Historical Trends Dashboard: Year-long magnitude trend chart, monthly frequency breakdown, and most active regions
• Advanced Search: Filter earthquakes by date range, magnitude range, and place, with CSV export
• Watched Regions: Save specific places with a custom radius and magnitude threshold, and get a personalized alert feed plus browser notifications when matching earthquakes occur

Safety & Education

• Comprehensive Guidelines: Multi-phase safety instructions (before, during, after)
• Resource Library: Technical reports, research papers, and educational materials
• Multi-language Support: Content available in English and Amharic
• Emergency Services: Integration with local emergency service locations

Technical Features

• Real-time Updates: WebSocket integration for instant notifications
• Offline Support: Progressive Web App (PWA) capabilities
• Responsive Design: Mobile-first approach with dark/light theme support
• Customizable Alerts: User-defined notification preferences

🛠️ Technology Stack

Frontend

• Framework: Next.js 14 (App Router)
• UI/Styling:
  • Tailwind CSS
  • shadcn/ui components
  • Custom responsive design
• State Management:
  • Zustand for global state
  • React Context for theme/settings

Data Visualization

• Maps: Leaflet with React-Leaflet
• Charts: Recharts for statistical analysis
• Custom Components:
  • Risk heatmap
  • Seismic activity graphs
  • Prediction models

Data Integration

• Primary Source: USGS Earthquake API
• Real-time Updates: WebSocket implementation
• Data Processing: Custom algorithms for risk assessment

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Commit changes
4. Push to branch
5. Open a Pull Request

Contribution Guidelines

• Follow TypeScript best practices
• Write comprehensive tests
• Update documentation
• Follow the existing code style
• Add meaningful commit messages

📝 License

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

👨‍💻 Author

Kidus Yohannes

• GitHub: @kidyoh
• LinkedIn: Kidus Yohannes
• Email: kidyoh789@gmail.com

🙏 Acknowledgments

• USGS for earthquake data API
• OpenStreetMap for map tiles
• Ethiopian Geological Survey
• shadcn/ui for UI components
• The open-source community

📧 Support

For support, email kidyoh789@gmail.com or open an issue in the repository.

---

Built with ❤️ for Ethiopia's seismic safety