Repository files navigation

This is a sample app & basic code that demonstrate how to build an Android application using the Uncle Bob's Clean Architecture approach.

The trick of the project is to demonstrate best practices, provide a set of guidelines, and present modern Android Application Architecture that is modular, scalable, maintainable and testable, suitable for bigger teams and long application lifecycle management.

Because it is an architectural project, UI has been kept simple. Sample data has been provided fromJsonPlaceholder API You can directly clone the repo and run the app.

This app usesMVI (Model View Intent) architecture.

Modules are the collection of source files and build settings that allow you to divide your project into discrete units of functionality.

• App Module

  :app module is ancom.android.application, which is needed to create the app bundle. It contains dependency graph and UI related classes. It presents data to screen and handle user interactions.

• Base Module

  :base module contains only framework related base classes that is used in other modules

• Common Module

  :common module contains code and resources which are shared between other modules

• Data Module

  :data module contains implementation of repository and local - remote repository interface adapt

• Domain Module

  :domain module contains use cases and repository interface adapt

• Local Module

  :local module contains local data source related classes

• Remote Module

  :remote module contains remote data source related classes

• Presentation Module

  :presentation module contains business logic

Each module has its own test.

• Kotlin
• Jetpack
  • Android KTX
  • Lifecycle
  • Data Binding
  • View Binding
  • ViewModel
  • Navigation Component
  • Room
• Coroutines - Flow
  • State Flow
  • Shared Flow
  • Channels
• Dagger Hilt
• Retrofit
• OkHttp
• KotlinX
• KotlinX Serialization Converter
• LeakCanary
• Testing
  • MockK
  • Junit4
  • Truth
  • Turbine
  • Fragment Testing
  • Navigation Testing
  • Coroutine Test
  • Barista
  • Dagger Hilt Testing

All contributions are welcome! Please fork this repository and contribute back usingpull requests.

• Linkedin
• Medium

Don't forget to star ⭐ the repo it motivates me to share more open source

MIT LicenseCopyright (c) 2021 Yusuf CeylanPermission is hereby granted, free of charge, to any person obtaining a copyof this software and associated documentation files (the "Software"), to dealin the Software without restriction, including without limitation the rightsto use, copy, modify, merge, publish, distribute, sublicense, and/or sellcopies of the Software, and to permit persons to whom the Software isfurnished to do so, subject to the following conditions:The above copyright notice and this permission notice shall be included in allcopies or substantial portions of the Software.THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS ORIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THEAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHERLIABILITY, 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 THESOFTWARE.