Android Template

🗡️ Android development with Hilt, Coroutines, Flow, Jetpack (Room, ViewModel), and Material Design based on MVVM architecture.

Tech stack & Open-source libraries

• Minimum SDK level 21
• Kotlin based, Coroutines + Flow for asynchronous.
• Jetpack
  • Lifecycle: Observe Android lifecycles and handle UI states upon the lifecycle changes.
  • ViewModel: Manages UI-related data holder and lifecycle aware. Allows data to survive configuration changes such as screen rotations.
  • DataBinding: Binds UI components in your layouts to data sources in your app using a declarative format rather than programmatically.
  • Room: Constructs Database by providing an abstraction layer over SQLite to allow fluent database access.
  • Hilt: for dependency injection.
• Architecture
  • MVVM Architecture (View - DataBinding - ViewModel - Model)
  • Bindables: Android DataBinding kit for notifying data changes to UI layers.
  • Repository Pattern
• Retrofit2 & OkHttp3: Construct the REST APIs and paging network data.
• Sandwich: Construct a lightweight and modern response interface to handle network payload for Android.
• Moshi: A modern JSON library for Kotlin and Java.
• WhatIf: Check nullable objects and empty collections more fluently.
• Bundler: Android Intent & Bundle extensions, which insert and retrieve values elegantly.
• ksp: Kotlin Symbol Processing API.
• Turbine: A small testing library for kotlinx.coroutines Flow.
• Material-Components: Material design components for building ripple animation, and CardView.
• Glide, GlidePalette: Loading images from network.
• TransformationLayout: Implementing transformation motion animations.
• Custom Views
  • Rainbow: An easy way to apply gradations and tinting for Android.
  • AndroidRibbon: A simple way to implement a beautiful ribbon with the shimmering on Android.
  • ProgressView: A polished and flexible ProgressView, fully customizable with animations.
• Timber: A logger with a small, extensible API.

Architecture

This Android Template is based on the MVVM architecture and the Repository pattern, which follows the Google's official architecture guidance.

The overall architecture of this template is composed of two layers; the UI layer and the data layer. Each layer has dedicated components and they have each different responsibilities, as defined below:

This template was built with Guide to app architecture, so it would be a great sample to show how the architecture works in real-world projects.

Architecture Overview

• Each layer follows unidirectional event/data flow; the UI layer emits user events to the data layer, and the data layer exposes data as a stream to other layers.
• The data layer is designed to work independently from other layers and must be pure, which means it doesn't have any dependencies on the other layers.

With this loosely coupled architecture, you can increase the reusability of components and scalability of your app.

UI Layer

The UI layer consists of UI elements to configure screens that could interact with users and ViewModel that holds app states and restores data when configuration changes.

• UI elements observe the data flow via DataBinding, which is the most essential part of the MVVM architecture.
• With Bindables, which is an Android DataBinding kit for notifying data changes, you can implement two-way binding, and data observation in XML very clean.

Data Layer

The data Layer consists of repositories, which include business logic, such as querying data from the local database and requesting remote data from the network. It is implemented as an offline-first source of business logic and follows the single source of truth principle.

This template is an offline-first app is an app that is able to perform all, or a critical subset of its core functionality without access to the internet. So users don't need to be up-to-date on the network resources every time and it will decrease users' data consumption. For further information, you can check out Build an offline-first app.

Modularization

This template adopted modularization strategies below:

• Reusability: Modulizing reusable codes properly enable opportunities for code sharing and limits code accessibility in other modules at the same time.
• Parallel Building: Each module can be run in parallel and it reduces the build time.
• Strict visibility control: Modules restrict to expose dedicated components and access to other layers, so it prevents they're being used outside the module
• Decentralized focusing: Each developer team can assign their dedicated module and they can focus on their own modules.

For more information, check out the Guide to Android app modularization.

Find this repository useful? :heart:

Support it by joining stargazers for this repository. :star:
Also, follow me on GitHub for my next creations! 🤩

The Unlicense

This is free and unencumbered software released into the public domain.

Anyone is free to copy, modify, publish, use, compile, sell, or
distribute this software, either in source code form or as a compiled
binary, for any purpose, commercial or non-commercial, and by any
means.

In jurisdictions that recognize copyright laws, the author or authors
of this software dedicate any and all copyright interest in the
software to the public domain. We make this dedication for the benefit
of the public at large and to the detriment of our heirs and
successors. We intend this dedication to be an overt act of
relinquishment in perpetuity of all present and future rights to this
software under copyright law.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.

For more information, please refer to <https://unlicense.org>