Weather APP is a cross-platform application built using Compose Multiplatform. It allows you to check the weather and air quality of your current location or search for weather information in different cities.
- Current Location Weather: Get weather details based on your current location.
- City Search: Search for weather information by city name.
- Air Quality: View air quality details.
- Detailed Location Info: Get more information about the selected location.
- Error Handling
- Multiplatform-Platform: Built with Compose Multiplatform, it runs on both Android and iOS.
- current app is created using Compose-Multiplatform-Wizard
- it should be same as official compose Multiplatform Wizard
- but it has more features by providing useful libraries and plugins that you may need during development.
- For this APP, we selected IOS and Android platforms. You can find the main libraries and plugins in libs.versions.toml.
It's important to be aware that using a non-official tools like Compose-Multiplatform-Wizard may involve risks in real projects because it may be outdated or has security issue but it awesome for learning because it has a lot of libraries and plugins. However, since this is a test project for learning purposes, it's acceptable to use.
| Get current user location in first launch of the app (when not has permission) | (when already has permission) |
|---|---|
 |
 |
| Search for weather by location or by city name | Show Air quality |
|---|---|
 |
 |
| More details about location | Handle error |
|---|---|
 |
 |
-
The current app architecture consists of two layers: UI, and data. This design was chosen because the project's business logic is relatively simple, involving only three screens and a single API call so no need to add Domain layer.
-
for caching just using memory cache because realm has problem which case current project to fail in build and other cache libraries has weak point because it still in beta for kotlin compose.
- check your system with KDoctor
- install JDK 17 or higher on your machine (JDK 21 recommended)
- add
local.propertiesfile to the project root and set a path to Android SDK there
To run the application on android device/emulator:
- open project in Android Studio and run imported android run configuration
To build the application bundle:
- run
./gradlew :composeApp:assembleDebug - find
.apkfile incomposeApp/build/outputs/apk/debug/composeApp-debug.apkRun android UI tests on the connected device:./gradlew :composeApp:connectedDebugAndroidTest
Contributions are welcome! If you have ideas for improvements, bug fixes, or new features, please open an issue or submit a pull request.
To run the application on iPhone device/simulator:
- Open
iosApp/iosApp.xcprojectin Xcode and run the standard configuration. - Alternatively, use the Kotlin Multiplatform Mobile plugin for Android Studio.
- Run iOS simulator UI tests:
./gradlew :composeApp:iosSimulatorArm64Test.
If you have any questions or need further assistance, feel free to reach out: https://www.linkedin.com/in/ahmed-hany-youssef/