Skip to content

Dukeabaddon/earthph

Repository files navigation

EarthPH - Philippines Earthquake Monitor

Real-time earthquake monitoring dashboard for the Philippines using PHIVOLCS data

Live Demo React Tailwind CSS License

EarthPH - Interactive Earthquake Map

Interactive earthquake monitoring map showing recent seismic activity across the Philippines


About

EarthPH is a real-time earthquake monitoring web application that visualizes seismic activity across the Philippines. The application displays earthquake events on an interactive map with automatic updates every 60 seconds, providing citizens with up-to-date information about seismic activity in their region.


Features

Live Earthquake Monitoring

  • Interactive Map - Visual representation of earthquake locations using Leaflet.js
  • 24-Hour View - Displays earthquakes from the past 24 hours
  • Precise Location - Geographic coordinates and descriptive location names
  • Magnitude Display - Color-coded markers based on earthquake intensity
  • Impact Zones - Shows estimated shaking radius when clicking on events

Event Details

Click any earthquake marker to view:

  • Date & Time - When the earthquake occurred (UTC timezone)
  • Coordinates - Exact latitude and longitude
  • Depth - Distance below the Earth's surface (in kilometers)
  • Magnitude - Richter scale measurement
  • Location - Human-readable location description from PHIVOLCS

Data Management

  • 24-Hour Retention - Automatically cleans up earthquakes older than 24 hours
  • Reliable Data - Information stored in Supabase PostgreSQL database
  • Fast Performance - Optimized API with rate limiting and caching

Technology

Built with modern web technologies for optimal performance:


Data Source

All earthquake data is provided by the Philippine Institute of Volcanology and Seismology (PHIVOLCS), a service agency of the Department of Science and Technology (DOST).

Data Source: PHIVOLCS Earthquake Information

Attribution: All earthquake data is the property of PHIVOLCS/DOST. This application is for educational and public information purposes only.

Data Updates: The application provides access to earthquake events from the past 24 hours. Data can be refreshed manually or via scheduled scraper (not currently automated).


License

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

Usage Terms

  • Free to use for personal and educational purposes
  • Data attribution to PHIVOLCS is required
  • Modifications and derivatives allowed under MIT License
  • Commercial use should verify compliance with PHIVOLCS terms

Acknowledgments

  • PHIVOLCS - For providing public earthquake data
  • Leaflet.js - Open-source mapping library
  • OpenStreetMap - Map tile providers
  • Philippines DOST - Department of Science and Technology

Status

Current Version: 1.0.0
Status: Active & Maintained
Last Updated: November 2025


Built for the safety and awareness of Filipino citizens

About

Real-time earthquake monitoring dashboard for the Philippines using PHIVOLCS data

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors