🌤 SkyCast – Real-Time Weather App

SkyCast is a modern Android weather application built with Kotlin that provides
real-time weather information, detailed metrics, and dynamic UI updates using the
OpenWeatherMap API.

The app demonstrates practical Android development concepts such as
API integration, networking, and responsive UI design.

---

✨ Features

• Search weather for any city worldwide
• View real-time temperature, humidity, and wind speed
• Display sunrise and sunset timings
• Dynamic weather conditions and background UI
• Fast and lightweight API-based data fetching
• Clean and intuitive Android user interface

---

🛠 Tech Stack

• Language: Kotlin
• Networking: Retrofit + Gson
• API: OpenWeatherMap REST API
• UI: XML Layouts, Material Design
• IDE: Android Studio
• Version Control: Git & GitHub

---

📦 Installation

1. Clone the repository

   git clone https://github.com/akeelshafi/WeatherApp.git
   

2. Open in Android Studio

   • Select Open an existing project
   • Navigate to the cloned folder

3. Add your OpenWeatherMap API key

   • Get a key from https://openweathermap.org/api
   • Replace YOUR_API_KEY in the project with your key

4. Run the app

   • Use an emulator or real Android device

---

📱 Usage

1. Launch the application
2. Enter a city name in the search bar
3. View live weather details instantly

---

🎯 Learning & Project Goals

This project demonstrates:

• Real-world REST API integration in Android
• Handling network responses and JSON parsing
• Building a clean and responsive mobile UI
• Applying practical Kotlin-based Android development

---

🔮 Future Improvements

• Current location-based weather (GPS)
• Dark mode support
• 7-day forecast feature
• Migration to MVVM + Clean Architecture
• Offline caching of last searched weather

---

🤝 Contributing

Contributions are welcome.

1. Fork the repository

2. Create a feature branch

   git checkout -b feature/NewFeature

3. Commit your changes

4. Push and open a Pull Request

---

👨‍💻 Author

Akeel Shafi Android Developer

• GitHub: https://github.com/akeelshafi
• Email: akeelshafi20@gmail.com
• LinkedIn: https://linkedin.com/in/akeel-shafi

---

⭐ Recruiter Note

SkyCast highlights:

• Practical API-driven Android development
• Clean UI/UX implementation
• Real-world data handling and networking
• Strong foundation for production-level Android apps