{"id":13428933,"url":"https://github.com/android10/Android-CleanArchitecture-Kotlin","last_synced_at":"2025-03-16T02:30:50.949Z","repository":{"id":39618163,"uuid":"92510608","full_name":"android10/Android-CleanArchitecture-Kotlin","owner":"android10","description":"This is a movies sample app in Kotlin, which is part of a serie of blog posts I have written about architecting android application using different approaches.","archived":false,"fork":false,"pushed_at":"2024-08-25T17:02:48.000Z","size":897,"stargazers_count":4746,"open_issues_count":72,"forks_count":941,"subscribers_count":153,"default_branch":"main","last_synced_at":"2025-03-12T04:11:12.268Z","etag":null,"topics":["android","android-cleanarchitecture-kotlin","android-development","architectural","architectural-patterns","clean-architecture","functional-programming","kotlin","kotlin-android","lessons-learned","mobile-development"],"latest_commit_sha":null,"homepage":"https://fernandocejas.com/2018/05/07/architecting-android-reloaded/","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/android10.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-05-26T12:55:52.000Z","updated_at":"2025-03-09T09:40:52.000Z","dependencies_parsed_at":"2024-01-14T02:39:18.393Z","dependency_job_id":"4cf8c376-3b2e-4716-9da4-2934c4385faa","html_url":"https://github.com/android10/Android-CleanArchitecture-Kotlin","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/android10%2FAndroid-CleanArchitecture-Kotlin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/android10%2FAndroid-CleanArchitecture-Kotlin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/android10%2FAndroid-CleanArchitecture-Kotlin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/android10%2FAndroid-CleanArchitecture-Kotlin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/android10","download_url":"https://codeload.github.com/android10/Android-CleanArchitecture-Kotlin/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243815625,"owners_count":20352202,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","android-cleanarchitecture-kotlin","android-development","architectural","architectural-patterns","clean-architecture","functional-programming","kotlin","kotlin-android","lessons-learned","mobile-development"],"created_at":"2024-07-31T01:01:09.200Z","updated_at":"2025-03-16T02:30:50.341Z","avatar_url":"https://github.com/android10.png","language":"Kotlin","readme":"![banner](https://user-images.githubusercontent.com/37318022/40349145-3e0c8d8a-5dd8-11e8-8654-5784f9ab7554.png)\n\n# STATUS: Refactoring! Please check the TODOs below in the **project status section**.\n\n# Android - Clean Architecture - Kotlin [![Build Status](https://travis-ci.org/android10/Android-CleanArchitecture-Kotlin.svg?branch=main)](https://travis-ci.org/android10/Android-CleanArchitecture-Kotlin) [![codecov](https://codecov.io/gh/android10/Android-CleanArchitecture-Kotlin/branch/main/graph/badge.svg?token=x1AtDcNuDv)](https://codecov.io/gh/android10/Android-CleanArchitecture-Kotlin)\nThe purpose of this repo is to follow up Clean Architecture principles by bringing them to Android. It is worth saying that the idea is to take advantage of the Kotlin Programming Language features plus also pull in lessons learned and ideas from other interesting approaches like Functional Programming.\n\n## Project Status\n\n - **Last Update: 2024.08**\n   - WIP: Migrate to Kotlin 2.0.\n   - WIP: Migrate to Jetpack Compose.\n   - TODO: Bug Fixes.\n   - TODO: Reorganize and cleanup tests.\n   - TODO: Reorganize dependencies and build system. \n\n## Blog post with implementation details explanation:\n[Architecting Android… Reloaded](https://fernandocejas.com/2018/05/07/architecting-android-reloaded/)\n\n## Android - Clean Architecture - Java:\nThere is another Android Clean Architecture repository written in Java: https://github.com/android10/Android-CleanArchitecture with really nice discussions: https://github.com/android10/Android-CleanArchitecture/issues.\nArticle, lessons learned and some more material coming up. Check the following known bugs and TODO list. \n\n## Other material worth reading:\n\n[Architecting Android…The clean way?](http://fernandocejas.com/2014/09/03/architecting-android-the-clean-way/)\n\n[Architecting Android…The evolution](http://fernandocejas.com/2015/07/18/architecting-android-the-evolution/)\n\n[Tasting Dagger 2 on Android](http://fernandocejas.com/2015/04/11/tasting-dagger-2-on-android/)\n\n[Clean Architecture…Dynamic Parameters in Use Cases](http://fernandocejas.com/2016/12/24/clean-architecture-dynamic-parameters-in-use-cases/)\n\n### ----------------------------------------------------------------------------------------------\n\n## Sample app\n![](https://user-images.githubusercontent.com/1360604/31345866-679a221a-ad17-11e7-8097-7800edb677fa.gif)\n\n### ----------------------------------------------------------------------------------------------\n\n## Clean Architecture\n![https://fernandocejas.com/2018/05/07/architecting-android-reloaded/](https://github.com/android10/Sample-Data/blob/master/Android-CleanArchitecture-Kotlin/architecture/clean_architecture_reloaded_main.png)\n\n### ----------------------------------------------------------------------------------------------\n\n## Android 3 Layers Architecture\n![https://fernandocejas.com/2018/05/07/architecting-android-reloaded/](https://github.com/android10/Sample-Data/blob/master/Android-CleanArchitecture-Kotlin/architecture/clean_architecture_reloaded_layers.png)\n\n### ----------------------------------------------------------------------------------------------\n\n## UI Layer: MVVM \n![https://fernandocejas.com/2018/05/07/architecting-android-reloaded/](https://github.com/android10/Sample-Data/blob/master/Android-CleanArchitecture-Kotlin/architecture/clean_architecture_reloaded_mvvm_app.png)\n\n### ----------------------------------------------------------------------------------------------\n\n## Data Layer: Repository \n![https://fernandocejas.com/2018/05/07/architecting-android-reloaded/](https://github.com/android10/Sample-Data/blob/master/Android-CleanArchitecture-Kotlin/architecture/clean_archictecture_reloaded_repository.png)\n\n### ----------------------------------------------------------------------------------------------\n\n## Local Development\nHere are some useful Gradle/adb commands for executing this example:\n\n * `./gradlew runApp` - Builds and install the debug apk on the current connected device.\n * `./gradlew compileApp` - Builds the debug apk.\n * `./gradlew runUnitTests` - Execute unit tests (both unit and integration).\n * `./gradlew runAcceptanceTests` - Execute acceptance and instrumentation tests in the connected device.\n * `./gradlew runTestCoverage` - Reports code coverage on tests within the Android codebase.\n * `./gradlew runStaticCodeAnalysis` - Run static analysis on the Android codebase.\n \n## Discussions\nRefer to the issues section: https://github.com/android10/Android-CleanArchitecture-Kotlin/issues\n \n## License\n\n    Copyright 2024 Fernando Cejas\n\n    Licensed under the Apache License, Version 2.0 (the \"License\");\n    you may not use this file except in compliance with the License.\n    You may obtain a copy of the License at\n\n       http://www.apache.org/licenses/LICENSE-2.0\n\n    Unless required by applicable law or agreed to in writing, software\n    distributed under the License is distributed on an \"AS IS\" BASIS,\n    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n    See the License for the specific language governing permissions and\n    limitations under the License.\n\n\n![https://fernandocejas.com](https://github.com/android10/Sample-Data/blob/master/android10/android10_logo_big.png)\n\n\u003ca href=\"https://www.buymeacoffee.com/android10\" target=\"_blank\"\u003e\u003cimg src=\"https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png\" alt=\"Buy Me A Coffee\" style=\"height: auto !important;width: auto !important;\" \u003e\u003c/a\u003e\n","funding_links":["https://www.buymeacoffee.com/android10"],"categories":["Samples","Kotlin"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandroid10%2FAndroid-CleanArchitecture-Kotlin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandroid10%2FAndroid-CleanArchitecture-Kotlin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandroid10%2FAndroid-CleanArchitecture-Kotlin/lists"}