🌍 Earthquake Tracker App

📖 Description

The Earthquake Tracker App is a real-time earthquake monitoring application built using Flutter. It utilizes the USGS Earthquake API to fetch real-time data on earthquakes happening worldwide. Users can select a specific date range to view earthquakes within that period, including details such as magnitude, location, time, and severity levels represented by different colors. The app also supports both light mode and dark mode for enhanced user experience.

🛠️ Tech Stack & Packages Used

• Flutter: Frontend framework for building the application.
• USGS Earthquake API: For fetching real-time earthquake data.
• Provider: State management solution for managing app-wide state.
• HTTP: For making API requests.
• Geolocator: For fetching user location.
• Geocoding: To convert latitude and longitude into readable location names.

✨ Features

✅ Real-time Earthquake Data - Fetches real-time earthquake data from USGS.

✅ Date-based Filtering - Users can select a start date and end date to view past earthquake data.

✅ Detailed Earthquake Info - Displays magnitude, time, location, and severity.

✅ Danger Level Indication - Uses Red (high risk) and Green (low risk) colors for severity indication.

✅ Dark Mode Support - Seamlessly switch between light and dark themes.

✅ User Location Tracking - Allows users to find earthquakes near their location.

🚀 How It Works

1. Fetch Data: The app fetches earthquake data using the USGS API.
2. Filter by Date: Users can pick a date range to filter earthquake records.
3. Display Earthquake Details: Shows earthquake magnitude, time, location, and severity.
4. Severity Indication: Earthquakes above a certain magnitude appear in Red; others appear in Green.
5. Dark/Light Mode: Users can toggle between dark and light themes for a better experience.

🔮 Future Scope

🔹 Push Notifications: Alerts for nearby or significant earthquakes.

🔹 Map Integration: Visual representation of earthquakes on a world map.

🔹 More Filtering Options: Sorting based on intensity, location, etc.

🔹 Offline Mode: Save recent earthquake data for offline access.

Certainly! Below are the Contributing Guidelines and Code of Conduct sections formatted to match your README style. You can directly copy and paste them below your existing content.

---

📂 Installation & Setup

1. Clone the repository:

   git clone https://github.com/Fenirok/Earthquake_app.git  

2. Navigate to the project directory:

   cd Earthquake_app  

3. Install dependencies:

   flutter pub get  

4. Run the app:

   flutter run  

---

🤝 Contributing Guidelines

We’re excited to welcome contributions! Please follow these steps to make sure your changes are merged into the correct branch (test1):

🔁 Step-by-Step Guide

1. Fork the Repository
   Click the Fork button in the top-right corner of the Earthquake Tracker App repository to create your own copy.

2. Clone Your Fork Locally

   git clone https://github.com/your-username/Earthquake_app.git
   cd Earthquake_app

3. Create a New Branch
   It's a good practice to work in a feature branch:

   git checkout -b your-feature-name

4. Make Your Changes
   Add your feature, fix bugs, or improve documentation as needed.

5. Push Your Changes

   git add .
   git commit -m "Add: brief description of your changes"
   git push origin your-feature-name

6. Create a Pull Request

   • Go to your forked repository on GitHub.
   • Click “Compare & pull request”.
   • Change the base branch to test1 (not master):

     ✅ base: Fenirok: test1
     ✅ compare: your-username: your-feature-name

7. Submit Your Pull Request
   Provide a clear title and description for your changes. Then click “Create pull request”.

⚠️ Important:

Please do not submit pull requests to the master branch. All contributions should target the test1 branch to ensure stability and testing before merging to production.

---

📏 Code of Conduct

We are committed to providing a welcoming and inclusive environment for everyone. By participating in this project, you agree to follow our Code of Conduct:

• Be respectful and considerate.
• Avoid discriminatory or harassing behavior.
• Respect differing viewpoints and experiences.
• Use inclusive and constructive language.

Violations of the Code of Conduct may be reported by contacting the maintainers. Appropriate action will be taken to ensure a safe and respectful environment.

---

📜 License

This project is open-source and available under the MIT License.

---

Made with ❤️ using Flutter.