Git Trending Repos

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.

Video

https://github.com/oblakr24/GitTrendingCompose/assets/32245831/eb864a02-b4ad-41b5-afba-5e4b1f3d4b80

Features

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.

Technologies

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