igorwojda/android-showcase
Android Showcase
This is an open-source Android application that serves as a reference implementation for modern app architecture. It demonstrates a modular, testable structure built with Kotlin, Coroutines, and Jetpack libraries, organized into independent feature modules that each follow Clean Architecture and the MVVM pattern.
The project enforces coding standards through an automated static analysis pipeline that integrates linting, formatting checks, and code quality tools directly into the build process, failing the build on any violations. It uses reusable Gradle convention plugins to standardize build configuration across all modules, and centralizes all library and plugin versions in a single TOML file for consistent dependency management. A notable differentiator is wallpaper-based dynamic theming, which reads the device wallpaper's dominant colors at runtime and applies them as a color scheme using Material You APIs on supported Android versions.
The application itself includes music album browsing with search functionality, detailed album views with track listings, and local storage for marking and accessing favorite albums. User preferences can be adjusted through a dedicated profile screen. The project's documentation and build configuration are designed to serve as a practical reference for developers adopting multi-module Android architectures.
Features
- Android App Architecture Patterns - Demonstrates a modular, testable Android application architecture using modern Jetpack libraries, Clean Architecture, and feature modules.
- Gradle Convention Plugins - Encapsulates shared Gradle configuration into reusable convention plugins, reducing duplication and enforcing consistency.
- Gradle Convention Plugins - Encapsulates common build logic into reusable plugins shared across all project modules.
- Code Quality and Analysis - Runs linting, static analysis, and formatting verification through automated tasks and CI pipelines.
- Gradle Convention Plugins - Provides reusable Gradle convention plugins that standardize build configuration across multiple modules.
- Architecture Reference Apps - Serves as an example Android application demonstrating modern development practices with Kotlin, Coroutines, and Jetpack libraries.
- Multi-Module Architectures - Demonstrates a multi-module Android project structured into feature modules with Clean Architecture and MVVM patterns.
- Functionality Module Organizations - Organizes the application into independent, reusable modules that each contain their own architecture layers.
- Modular Feature Architectures - Organizes the app into independent feature modules, each with its own presentation, domain, and data layers.
- Static Code Analysis - Integrates linting, formatting, and code quality checks directly into the build pipeline, failing on violations.
- MVVM with Reactive State - Binds UI components to ViewModels that expose state as Kotlin Flow streams, with coroutines managing async operations.
- Dependency Version Managers - Centralizes all library and plugin versions in a single TOML file for consistent dependency management.
- Dependency Versioning - Centralizes all third-party library and plugin versions in a single configuration file for consistent project-wide use.
- Gradle Version Catalogs - Centralizes dependency management using a Gradle version catalog for consistent library and plugin versions.
- Music Album Browsers - Displays a list of music albums and filters them by name through a search interface.
- Wallpaper-Based Theming - Adapts the app's color scheme to match the device wallpaper on supported Android OS versions.
- Album Detail Views - Shows detailed information for a selected album, including its full track listing.
- Wallpaper Color Extractors - Reads the device wallpaper's dominant colors at runtime and applies them as a dynamic color scheme using Material You APIs.
- Dynamic Theming - Adapts the app's color scheme to match the device wallpaper on supported operating system versions.
