The purpose of this app is to offer an unbiased view of weather data without all the fuss (ads, tracking, data mining). The app is themed after the Yellow-rumped Warbler bird.
- Written in Kotlin
- Uses Kotlin Coroutines
- Android Architecture Components
- Jetpack Navigation
- LiveData
- Flow
- ViewBinding
- DataBinding
- Retrofit - An HTTP client for Android
- Room Database
- DataStore
- Dependency Injection using Dagger Hilt for Android
- Notifications
- MVVM
- Material Design Components for Android
- Testing includes
- Charts by Vico
- City Finder
- Location Service
- Favorites
- Weather Icons
- Current Weather data from Open Weather Map
- Forecast
- Hourly
- Air Quality
This app uses MVVM (Model View View-Model) architecture.
In the build.gradle, you will find an associated weather API key assigned, so you will want to
visit Open Weather Map and sign up to get an API key.
Once you have an API key, place it in your global gradle.properties file or in your environment.
It should look like this, replacing <api-key> with the actual key:
WEATHER_API_KEY=<api-key>
There are UI tests setup to run Espresso tests. Unit tests are also configured and uses Mockito.
This project is configured to run Github Actions and uses Dependabot for dependency updates. The GitHub Actions will run both unit tests and UI tests on master, or pull requests.
Since this project is open source, contributing is encouraged.
Color theme by Color Hunt, chosen to emulate the color of the Yellow-rumped Warbler bird.
MIT License
Copyright (c) 2023 Josh Ludahl
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.