{"id":14979951,"url":"https://github.com/drjacky/mvvmtemplate","last_synced_at":"2025-05-15T04:03:10.087Z","repository":{"id":37013120,"uuid":"256785326","full_name":"Drjacky/MVVMTemplate","owner":"Drjacky","description":"An Android Template with MVVM and Clean Architecture","archived":false,"fork":false,"pushed_at":"2025-03-15T11:06:52.000Z","size":48163,"stargazers_count":853,"open_issues_count":7,"forks_count":126,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-04-03T11:07:14.180Z","etag":null,"topics":["android","android-template","clean-architecture","cleanarchitecture","compose","coroutine","coroutines","coroutines-android","flow","gradle","hilt","jetpack-compose","kotlin","kotlin-dsl","mvvm","navigation-component","pagination-component","rxjava2","template-project"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Drjacky.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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},"funding":{"github":"Drjacky"}},"created_at":"2020-04-18T15:19:13.000Z","updated_at":"2025-03-31T10:30:24.000Z","dependencies_parsed_at":"2023-12-15T15:46:08.423Z","dependency_job_id":"e688ea2c-3a64-4af0-9ef1-536ca4d36b1f","html_url":"https://github.com/Drjacky/MVVMTemplate","commit_stats":{"total_commits":297,"total_committers":5,"mean_commits":59.4,"dds":0.05387205387205385,"last_synced_commit":"6b9a39454e9260b6d979ca5c02f633e5e2d4bd2d"},"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Drjacky%2FMVVMTemplate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Drjacky%2FMVVMTemplate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Drjacky%2FMVVMTemplate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Drjacky%2FMVVMTemplate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Drjacky","download_url":"https://codeload.github.com/Drjacky/MVVMTemplate/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248368876,"owners_count":21092472,"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-template","clean-architecture","cleanarchitecture","compose","coroutine","coroutines","coroutines-android","flow","gradle","hilt","jetpack-compose","kotlin","kotlin-dsl","mvvm","navigation-component","pagination-component","rxjava2","template-project"],"created_at":"2024-09-24T14:00:59.566Z","updated_at":"2025-04-11T09:39:10.472Z","avatar_url":"https://github.com/Drjacky.png","language":"Kotlin","funding_links":["https://github.com/sponsors/Drjacky"],"categories":[],"sub_categories":[],"readme":"# MVVMTemplate 🧞‍\n\n![Language](https://img.shields.io/badge/Kotlin-2.0.0-blue) ![License](https://img.shields.io/github/license/Drjacky/MVVMTemplate?logo=MIT) [![Actions Status](https://github.com/Drjacky/MVVMTemplate/workflows/Pre%20Merge%20Checks/badge.svg)](https://github.com/Drjacky/MVVMTemplate/actions) [![Build Status](https://github.com/Drjacky/MVVMTemplate/workflows/Android%20CI/badge.svg)](https://github.com/Drjacky/MVVMTemplate/actions) [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=Drjacky_MVVMTemplate\u0026metric=alert_status)](https://sonarcloud.io/dashboard?id=Drjacky_MVVMTemplate)\n[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2FDrjacky%2FMVVMTemplate.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2FDrjacky%2FMVVMTemplate?ref=badge_shield)\n[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-MVVMTemplate-green.svg?style=flat)](https://android-arsenal.com/details/1/8368) [![CodeScene Code Health](https://codescene.io/projects/29433/status-badges/code-health)](https://codescene.io/projects/29433)\n\u003c!-- [![Known Vulnerabilities](https://snyk.io/test/github/Drjacky/MVVMTemplate/badge.svg)](https://snyk.io/test/github/Drjacky/MVVMTemplate) Snyk doesn't support kotlin dsl --\u003e\n\n##\n\n\u003cp align=\"center\"\u003e\n  \u003cimg width=\"300px\" src=\"https://raw.githubusercontent.com/Drjacky/MVVMTemplate/master/gif/logo.svg\" /\u003e\n\u003c/p\u003e\n\nA simple Android template that lets you create an **Android** project quickly.\n\n## How to use 👣\n\nJust click\non [![Use this template](https://img.shields.io/badge/-Use%20this%20template-brightgreen)](https://github.com/Drjacky/MVVMTemplate/generate)\nbutton to create a new repo starting from this template.\n\n## Compose version ⭐\n\nFor the compose version, which is under development, switch\nto [feature/compose](https://github.com/Drjacky/MVVMTemplate/tree/feature/compose) branch.\n\n## Features 🕹\n\n- 100% Kotlin-only template\n- Following [Clean Architecture approach](https://proandroiddev.com/mvvm-with-clean-architecture-c2c021e05c89)\n- Following MVVM Architectural Design Pattern\n- Template Project\n- [RxJava 3](https://github.com/ReactiveX/RxJava) - Reactive Extensions for the JVM\n- [Coroutines](https://developer.android.com/kotlin/coroutines) - A concurrency design pattern library\n- [Flow](https://developer.android.com/kotlin/flow) - Built on top of coroutines and is stream of data that can be computed asynchronously\n- Simplest Adapter Ever (based on this [workaround](https://proandroiddev.com/the-best-android-recycler-adapter-youve-ever-seen-probably-177e25279a28))\n- Github Actions - CI\n- [Hilt](https://dagger.dev/hilt/) - Dependency Injection framework\n- [Transition](https://developer.android.com/guide/navigation/navigation-animate-transitions) - Animation\n- [Paging V3](https://developer.android.com/topic/libraries/architecture/paging/v3-overview) - Pagination\n- [View Binding](https://developer.android.com/topic/libraries/view-binding) - View Binding\n- [OkHttp3](https://github.com/square/okhttp) - Network interceptor\n- [Retrofit](https://github.com/square/retrofit) - HTTP client\n- [Glide](https://github.com/bumptech/glide) - Loading images\n- [Timber](https://github.com/JakeWharton/timber) - Log\n- [Gson](https://github.com/google/gson) - JSON library\n- [Material Components](https://github.com/material-components/material-components-android) - Material Design\n- [Lottie](https://airbnb.design/lottie/) - Vector animation library\n- [Kotlin DSL](https://docs.gradle.org/current/userguide/kotlin_dsl.html) - Alternative syntax to\n  the Groovy DSL\n- [Detekt](https://github.com/detekt/detekt) - Static code analysis for Kotlin\n- [Gradle Doctor](https://github.com/runningcode/gradle-doctor) - Gradle build scan plugin\n- [Navigation](https://developer.android.com/guide/navigation) - Navigate through the app\n- [LeakCanary](https://square.github.io/leakcanary/) - Memory leak detection\n- [Chucker](https://github.com/ChuckerTeam/chucker) - An HTTP inspector for Android \u0026 OkHTTP\n- [StrictMode](https://developer.android.com/reference/android/os/StrictMode) - A developer tool\n  which detects things you might be doing wrong by accident\n- [Dark/Light Theme](https://developer.android.com/guide/topics/ui/look-and-feel/darktheme) -\n  Support dark/light themes\n- [DataStore](https://developer.android.com/topic/libraries/architecture/datastore) - Data storage\n  solution that allows you to store key-value pairs or typed objects\n- [AutoDispose](https://uber.github.io/AutoDispose/) - Automatically binding the execution of RxJava\n  streams to a provided scope\n- [Dependency Analysis](https://github.com/autonomousapps/dependency-analysis-android-gradle-plugin) - Dependency analysis android gradle plugin\n- [Sonatype Scan Gradle Plugin](https://github.com/sonatype-nexus-community/scan-gradle-plugin)-\n  Gradle plugin that scans the dependencies of a Gradle project using Sonatype platforms: OSS Index\n  and Nexus IQ Server.\n\n## Under Development 🚧\n\n- ~~Add CI~~\n- ~~Use Kotlin DSL~~\n- Add Espresso, Instrumentation \u0026 Unit tests. To see a part of changes, click [here](https://github.com/Drjacky/MVVMTemplate/pull/18).\n- ~~Use Animations. To see changes, click [here](https://github.com/Drjacky/MVVMTemplate/commit/2fc51ef6ff82c4d43168e3ae0124a30c4ec3bfff).~~\n- ~~Use Hilt. To see changes, click [here](https://github.com/Drjacky/MVVMTemplate/commit/b8af89bb74e5d615e9704c9f3ce35befd11811ea).~~\n- ~~Migrate to [Hilt 2.31](https://github.com/google/dagger/releases/tag/dagger-2.31). To see changes, click [here](https://github.com/Drjacky/MVVMTemplate/commit/792d2ba54d214b3ef10862777fc386e7be5790f4).~~\n- ~~Use Paging V3. To see changes, click [here](https://github.com/Drjacky/MVVMTemplate/pull/4/files).~~\n- ~~Use ViewBinding. To see changes, click [here](https://github.com/Drjacky/MVVMTemplate/commit/cfc907532fa991cd8de3b295644bfdff88d67ceb).~~\n- Migrate to [JetPack Compose](https://developer.android.com/jetpack/compose)\n- ~~Use detekt. To see changes, click [here](https://github.com/Drjacky/MVVMTemplate/pull/6/files).~~\n- ~~Add coroutines and flow. To see changes, click [here](https://github.com/Drjacky/MVVMTemplate/pull/7/files).~~\n- ~~Replace Preferences by DataStore. To see changes, click [here](https://github.com/Drjacky/MVVMTemplate/commit/285892ce098e2a069324910a213b78cac2e643e8).~~\n- ~~Migrate from RxJava 2 to RxJava 3. To see changes, click [here](https://github.com/Drjacky/MVVMTemplate/pull/11).~~\n- ~~Add Custom Rx Adapter for Network Response Handling. To see changes, click [here](https://github.com/Drjacky/MVVMTemplate/pull/13/files).~~\n\n## CI 🏭\n\nThis template is using [**GitHub Actions**](https://github.com/Drjacky/MVVMTemplate/actions) as CI.\n\nAvailable workflows listed as follows:\n- [Validate Gradle Wrapper](.github/workflows/gradlew-validation.yml) - Checks the gradle wrapper has a valid checksum.\n- [Pre Merge Checks](.github/workflows/pre-merge.yml) - Runs `build` task. \n- [Android](.github/workflows/android.yml) - Runs `assembleDebug` task.\n\n## Tasks 🔧\n\n- Gradle Doctor: `dependencyUpdates` - Displays the dependency updates for the project.\n- Detekt: `detektAll` - Run the static Kotlin code analysis for the whole project at once.\n- The Dependency Analysis: `buildHealth` - Provides advice for managing dependencies and other\n  applied plugins.\n- Sonatype Scan Gradle Plugin - AKA Sherlock Trunks: `ossIndexAudit` - Scans the dependencies of a\n  Gradle project using Sonatype platforms; OSS Index and Nexus IQ Server.\n\n## References 🧷\n\n- [The Punk API](https://punkapi.com/)\n- [Right or Left animation by Marco Martina on LottieFiles](https://lottiefiles.com/21141-right-or-left)\n- [Loading Beer animation by Hashim Irfan on LottieFiles](https://lottiefiles.com/30697-loading-beer-animation)\n\n## Contributing 🤝\n\nFeel free to open an issue or submit a pull request for any bugs/improvements.\n\n## Result 📺\n\u003cimg src=\"https://raw.githubusercontent.com/Drjacky/MVVMTemplate/master/gif/path.gif\" width=\"350px\" height=\"700px\" /\u003e \u003cimg src=\"https://raw.githubusercontent.com/Drjacky/MVVMTemplate/master/gif/list.gif\" width=\"350px\" height=\"700px\" /\u003e\n### Compose\n\u003cimg src=\"https://raw.githubusercontent.com/Drjacky/MVVMTemplate/master/gif/compose.gif\" width=\"350px\" height=\"700px\" /\u003e\n\n## License ⚖️\n[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2FDrjacky%2FMVVMTemplate.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2FDrjacky%2FMVVMTemplate?ref=badge_large)\n\n## Star History Chart \n\n[![Star History Chart](https://api.star-history.com/svg?repos=Drjacky/MVVMTemplate\u0026Date\u0026type=Date)](https://star-history.com/#Drjacky/MVVMTemplate\u0026Date\u0026Date)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdrjacky%2Fmvvmtemplate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdrjacky%2Fmvvmtemplate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdrjacky%2Fmvvmtemplate/lists"}