A demo app displaying the trending git repositories, sorted by the number of stars descending, and for displaying the details of repositories.
Made using the latest Android development stack and architectural and UI development patterns, including Jetpack Compose and Material Design 3.
The app will load pages automatically once the user scrolls far enough (close enough to the last item) and supports offline mode and a togglable dark mode setting.
Partly intended as a comparison case study versus the Legacy XML Views implementation.
c1.mp4
-
Listing trending repositories: Trending repositories are listed in an infinitely scrollable list, with pages loaded dynamically. Scroll to-refresh to refresh the data.
-
Repository details: The repository can be opened to reveal the details and the rendered readme file markdown content.
-
Offline mode: The repositories are stored in a database for offline use and to make fewer requests when the data is not stale.
-
Dark mode: Toggle to override system settings. When toggled, the preference is persisted.
This app is made using:
- Jetpack Compose for UI with Material 3
- A mix of MVVM/MVI using Molecule for reactive state construction with Coroutines/Flows
- Room and Datastore for data and preferences persistence and offline support
- Standardized design and typography to match Material 3 and easy customization
Stack:
- MVVM architecture (mix of MVVM and MVI)
- Jetpack Compose and Compose Navigation: UI
- Hilt for dependency injection
- Molecule for the usage of Compose Compiler in the VM layer for reactive state construction
- Coil for image loading
- KotlinX Serialization for serialization and deserialization of models into and from files
- Retrofit for network requests
- Room for data persistence
- Extended Material icons for vector images
- DataStore for persisting user preferences
- Compose Markdown for Markdown rendering
- Compose Shimmer for loading item shimmer support
- Lottie-Compose for Composable JSON animations
- MockK for mocking in tests
- Turbine for testing Flows
Trending Repositories
Repository Details
