🌋 TerraQuake API

A modern, open-source seismic data platform providing real-time earthquake information through a RESTful API and interactive visualization interface.

Getting Started • Features • API Reference • Use Cases • Contributing

📑 Overview

TerraQuake is a comprehensive seismic data platform that combines a powerful REST API with an intuitive web interface. It provides researchers, developers, and organizations with easy access to real-time earthquake data, advanced filtering capabilities, and interactive visualizations.

---

Project Overview

• Backend (TerraQuake API) — Node.js + Express REST API to serve earthquake data.
• Frontend — React + TailwindCSS interface for visualizing seismic events.
• Data Source — INGV (Istituto Nazionale di Geofisica e Vulcanologia) and synthetic demo data.
• API Access — Public endpoints for querying earthquakes by time, magnitude, location, and more.

---

Technologies Used

Backend

• Node.js
• Express
• MongoDB (planned for persistent data)
• JWT (for secure access, future feature)
• Custom earthquake generator (for demo/testing)

Frontend

• React 19
• Vite
• Tailwind CSS 4
• React Router
• Hero sections, maps, charts (via Leaflet, Chart.js – if added)

---

Frontend Features

• Visualize earthquakes on an interactive map
• Filter events by date
• View statistics in chart format
• Educational UI: earthquake basics and seismic zones (planned)
• Search and filter functionality

---

Author

Dr. Gianluca Chiaravalloti Web Developer & Geologist Linkedin Portfolio

🤝 Contributing

Contributions are welcome!
If you’d like to improve TerraQuake API, please fork the repository and open a pull request.
Whether it’s fixing a bug, improving documentation, or adding a feature — all contributions are appreciated!

Please make sure to follow the contributing guidelines.

💬 Community

Join our community on Discord to connect, share ideas, and collaborate with other contributors.

🎉 Hacktoberfest 2025

This project is participating in Hacktoberfest 2025!
Contributions count toward the event. Feel free to submit PRs and join us in building TerraQuake API together 🌍

� Credits

Core Team

• Dr. Gianluca Chiaravalloti - Project Lead & Founder
  • Web Developer & Geologist
  • Portfolio

Key Contributors

• International team of 5 collaborators contributing to:
  • Backend Development
  • Frontend Enhancements
  • Testing & Quality Assurance
  • Documentation
  • Community Support

Data Sources & Partners

• INGV (Istituto Nazionale di Geofisica e Vulcanologia)
  • Primary source of seismic data
  • Technical consultation on seismological aspects

Technologies & Resources

• Frontend Technologies

  • React.js Documentation & Community
  • Tailwind CSS Framework
  • Vite Build Tool
  • OpenStreetMap for geographical data

• Backend Technologies

  • Node.js & Express.js Communities
  • MongoDB Documentation & Support
  • JWT Authentication Resources
  • ESLint & StandardJS

Special Thanks

• Open Source Community
• Early Adopters & Testers
• Bug Reporters & Feature Requesters
• Documentation Contributors

�💖 Support the Project

TerraQuake API is an open-source initiative aimed at making real-time seismic data accessible for developers, researchers, and communities.

If you find this project useful and would like to support its development, consider becoming a sponsor. Your contribution helps:

Maintain and improve the API

Add new features and documentation

Keep the project open and accessible to everyone

Even a small donation makes a big difference in keeping the project alive and growing.

Thank you for supporting open source and helping TerraQuake API reach more people! 🌍