https://github.com/barros9/beerapp
https://github.com/barros9/beerapp
android clean-architecture compose hilt modularization room
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/barros9/beerapp
- Owner: Barros9
- Created: 2022-10-31T18:23:08.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2024-08-16T17:16:13.000Z (about 1 year ago)
- Last Synced: 2025-04-06T06:43:01.177Z (7 months ago)
- Topics: android, clean-architecture, compose, hilt, modularization, room
- Language: Kotlin
- Homepage:
- Size: 1.29 MB
- Stars: 16
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Warning ⚠️
Since [Punk API](https://punkapi.com/) shut down, it is possible using the app with only the 20 beers items available in [BeerAppDatabase.db](https://github.com/Barros9/BeerApp/blob/master/libraries/beer/src/main/assets/BeerAppDatabase.db)
# BeerApp
A sample Android native app that shows a list of beers using the [Punk API](https://punkapi.com/). The app is based
on [Android developers architecture](https://developer.android.com/jetpack/guide?gclsrc=ds&gclsrc=ds)
developed with [Jetpack Compose](https://developer.android.com/jetpack/compose).
The app follows an implementation of mudularazition by features:
* Features
- *detail*, it shows the detail page
- *home*, it shows the main page
* Libraries
- *beer*, it exposes the information related beers and takes care of managing online and offline logic
- *navigator*, it provides a way to navigate between pages
- *ui*, it contains Compose theme configuration
## Medium
This app is mentioned in the following articles:
* [Android app modularization with Clean Architecture](https://barros9.medium.com/android-app-modularization-with-clean-architecture-9aa2e135a99a)
* [Android: Single Source Of Truth Strategy (Offline-First)](https://barros9.medium.com/android-single-source-of-truth-strategy-offline-first-5f6028f39d34)
* [A custom pagination in Compose — An alternative to the Android Paging Library](https://barros9.medium.com/a-custom-pagination-in-compose-an-alternative-to-the-android-paging-library-46dc043fb251)
## Libraries
* The network API requests are made using [Retrofit](https://github.com/square/retrofit) and the data are
stored with [Room](https://developer.android.com/training/data-storage/room)
* The Dependency Injection module is based
on [Hilt](https://developer.android.com/training/dependency-injection/hilt-android)
## Gradle
The Gradle build is implemented with Gradle’s Kotlin DSL, an alternative syntax to the traditional Groovy DSL.
## Thanks