Climo

Climo is a minimalist, open-source weather app designed to provide accurate weather updates in a clean and simple interface. Developed using Android Studio with Java and powered by WeatherAPI, Climo is perfect for those who appreciate functionality without unnecessary complexity. 🌦️

---

Features

• 🌍 Get the current weather for any city worldwide.
• 🧭 Clean and intuitive user interface.
• ⚡ Lightweight and optimized for modern devices.
• 🔑 Built-in support for easy integration with WeatherAPI keys.

---

For Contributors & Developers

Welcome to Climo! Thank you for your interest in contributing to this project. To ensure privacy and API efficiency, you need to obtain your own API key from WeatherAPI using their Free Plan.

How to Use Your WeatherAPI Key

1. Create a file apikeys.xml file under the directory res/values/.
2. Replace the placeholder <YOUR_API_KEY> with your WeatherAPI key:

   <resources>
       <string name="weather_api_key">YOUR_API_KEY</string>
   </resources>

3. Save the file and run the app in your preferred Android Virtual Device.

---

Android Virtual Device (AVD) Recommendation

For development and testing purposes, the app has been optimized for:

• Device: Pixel 9
• API Level: 34
• Android Version: Android 13 ("Tiramisu")

However, Climo is designed to run on any Android device with an API greater than or equal to 24 (Android 7.0 "Nougat").

---

How to Contribute to Climo

We are excited to have you on board! Here's how you can contribute to Climo:

1. Fork the Repository
   Navigate to the Climo GitHub Repository, and click on Fork. Clone your forked version locally:

   git clone git@github.com:<your-username>/Climo.git

2. Work on Issues
   Browse through the Issues tab or create a new one. Assign yourself to an issue if you plan to work on it.

3. Make Changes Locally
   Open the project in your IDE (we recommend Android Studio) and make your changes.

4. Submit a Pull Request (PR)
   Push your changes to your fork, and open a Pull Request. Ensure your PR references the relevant issue.

5. Get Reviewed & Merged
   Your PR will be reviewed by maintainers. If approved, it will be merged into the main branch.

6. Show Some Love
   Leave a ⭐ on the GitHub repository if you like the project!

---

For Users

Hello and welcome to Climo! 🌦️ This app is your personal weather assistant, offering real-time updates for any city around the globe.

How to Get Started

1. Download the app from the Releases page.
2. Enter the name of your city and tap "Consultar Clima".
3. View accurate weather details in an instant!

System Requirements

• Android Version: 7.0 (API 24) or higher.
• Internet connection required to fetch weather data.

---

Acknowledgments

Special thanks to:

• WeatherAPI for providing the weather data.
• The open-source community for inspiration and support.

---

License

This project is licensed under the MIT License. Feel free to use, modify, and distribute it in accordance with the terms of the license. See the LICENSE file for details.

---