The Android Architecture Samples repository is a collection of reference implementations maintained by Google that demonstrates different architectural approaches for building Android applications. The repository uses Kotlin as its primary language and is organized across multiple branches, each implementing the same TODO application with varying architectural patterns and tooling choices.
The main branch showcases a modern Android development approach built on Jetpack Compose for the user interface, combined with a single-activity architecture using Navigation Compose for screen navigation. The presentation layer follows the MVVM pattern, with each screen or feature having its own ViewModel. The implementation uses Flow and Kotlin coroutines to handle asynchronous operations and create reactive user interfaces. The data layer is structured with a repository pattern that abstracts two data sources: a local Room database and a mock remote data source. The project includes two product flavors, mock and prod, to facilitate development and testing workflows. Dependency injection is handled through Hilt, and the codebase includes comprehensive testing coverage with unit tests, integration tests, and end-to-end tests that can run on emulators or physical devices.
The repository explicitly positions itself as an educational resource rather than a production template or UI showcase. It is designed for intermediate developers and beginners seeking to understand how to structure testable and maintainable applications, while also serving as a quick reference for advanced developers. The TODO application was deliberately chosen as the sample project because it is simple enough to understand quickly but complex enough to illustrate difficult design decisions and testing scenarios.
The repository has received bug reports and questions as its most active issue types.
The repository covers multiple architectural patterns and design approaches, including MVVM, MVI, and clean architecture principles. It serves as a practical guide for implementing Jetpack libraries and best practices in Android development. The samples are designed to be opened directly in Android Studio, making them accessible for developers who want to study the code structure and patterns in a familiar development environment.
