Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/adamdawi/weather-app
Clean MVVM architecture app to display weather
https://github.com/adamdawi/weather-app
clean-architecture coroutines flow instrumentation-tests mvvm-pattern stateflow-android ui-testing unit-testing weather weather-api weather-app
Last synced: 10 days ago
JSON representation
Clean MVVM architecture app to display weather
- Host: GitHub
- URL: https://github.com/adamdawi/weather-app
- Owner: AdamDawi
- Created: 2024-06-06T14:01:19.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2024-10-24T08:39:35.000Z (4 months ago)
- Last Synced: 2024-10-25T05:19:30.381Z (4 months ago)
- Topics: clean-architecture, coroutines, flow, instrumentation-tests, mvvm-pattern, stateflow-android, ui-testing, unit-testing, weather, weather-api, weather-app
- Language: Kotlin
- Homepage:
- Size: 310 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 
Weather App
Discover detailed and accurate weather forecasts with Weather App. Utilizing advanced location services and real-time weather data, Weather App ensures you are always informed about the weather conditions in your area.
## ⭐️ Features
### Main Screen
- **Current Weather:** Displays the current weather, temperature, and an icon representing the weather condition.
- **Weather Forecast:** Shows a 9-day weather forecast, including the past 2 days and the next 6 days, with maximum and minimum temperatures and weather icons.
- **Location-Based Updates:** Automatically fetches weather data based on your current location.
- **Live Updates:** Updates weather data every 5 seconds using Kotlin's Flow and Coroutines. The updates pause when the app is in the background to save resources.
- **City Display:** Shows the city name based on your coordinates.
### Weather Details
- **Temperature Chart:** Beautiful chart displaying the maximum temperature and temperature changes over the past 7 hours, created using Jetpack Compose Canvas.
- **Current Conditions:** Displays the current temperature alongside the chart.
- **Additional Data Cards:**
- **Rain:** Displays current rainfall data with an icon.
- **Wind Speed:** Shows current wind speed data with an icon.
- **Humidity:** Displays current humidity levels with an icon.
- **Cloud Cover:** Shows current cloud cover with an icon.
- **Sunrise and Sunset:** A detailed card showing sunrise and sunset times and the current position of the sun on an arc, created using Jetpack Compose Canvas.
### Theming
- **Theme Switcher:** Toggle between dark mode and light mode using MaterialTheme.
## ⚙️ Technologies
### 📱 App:
- **Kotlin:** Primary language for app development.
- **Jetpack Compose:** For building responsive and modern UI.
- **Flow and Coroutines:** For handling real-time data updates and background tasks.
- **MVVM Clean Architecture:** Separates the project into layers with use cases, repositories, and view models.
- **Retrofit2:** For fetching weather data from the API.
- **Dagger Hilt:** For dependency injection.
- **Timber:** For logging.
- **Material Design:** For creating an intuitive and visually appealing interface.
### ✅ Testing:
- **JUnit:** For unit testing.
- **Mockito:** For mocking dependencies in tests.
- **Coroutines Test:** For testing coroutines.
- **Fake Repositories and APIs:** For testing.
- **Dagger Hilt:** For dependency injection in tests.
- **Compose UI Testing:** For UI and end-to-end testing.
## Installation
1. Clone the repository:
```bash
git clone https://github.com/AdamDawi/Weather-App
```
2. Open the project in Android Studio.
3. Be sure the versions in gradle are same as on github
## Here are some overview pictures:
| Light mode | Dark mode |
| ------------- | ------------- |
|  |  |
|  |  |
## Requirements
Minimum Version: Android 8.0 (API level 26) or later📱
Target Version: Android 14 (API level 34) or later📱
## Author
Adam Dawidziuk🧑💻