SkyCast is a modern, high-precision weather companion designed to give you clarity on the conditions around you. Built with a focus on speed, accuracy, and a minimalist user experience, SkyCast ensures you're always prepared for whatever the clouds bring.
- 📍 Real-Time Local Weather: Automatically detects your current location to provide hyper-local temperature, humidity, and atmospheric conditions.
- 🏙️ Global City Tracking: Search and save an unlimited number of cities. Monitor weather for your next travel destination or check in on family across the globe.
- 🔄 Instant Synchronization: Powered by the OpenWeather API, providing live data updates at your fingertips.
- 🎨 Modern Interface: A clean UI built entirely with Jetpack Compose for a smooth and fluid experience.
This project serves as a showcase of modern Android development best practices:
- Language: Kotlin
- UI Framework: Jetpack Compose
- Networking: ktor
- Local Database: Room Persistence Library
- Concurrency: Kotlin Coroutines & Flow
- Dependency Injection: koin
- Data Source: OpenWeather API
- Serialization: Kotlinx serialization
- Animation: Lottie animation
-
Clone the repository:
git clone https://github.com/Jesil-OT/Skycast.git
-
Get an API Key:
- Visit OpenWeatherMap.
- Create a free account and navigate to the API Keys tab in your dashboard.
- Generate a new key (it may take up to 2 hours to activate).
-
Configure the API Key:
- Open your project in Android Studio.
- Locate your
local.propertiesfile in the root directory. - Add the following line:
OPENWEATHER_API_KEY=your_api_key_here
-
Build and Run:
- Sync your project with Gradle files.
- Select your device or emulator.
- Click the Run button (Shift + F10).
To provide a seamless weather experience, SkyCast utilizes the following permissions:
ACCESS_FINE_LOCATION: Used to fetch high-accuracy weather data for your specific coordinate.ACCESS_COARSE_LOCATION: Used as a battery-efficient fallback for location detection.INTERNET: Required to communicate with the OpenWeather servers.
This project is licensed under the MIT License. You are free to use, modify, and distribute this software with attribution.
SkyCast — Clearer skies, smarter days.