{"id":21942057,"url":"https://github.com/malekkamel/contacts","last_synced_at":"2026-04-13T23:04:36.105Z","repository":{"id":90820852,"uuid":"377910641","full_name":"MalekKamel/Contacts","owner":"MalekKamel","description":"A sample Android project for Kotlin, MVVM, clean code, modular architecture, Room, ContentProvider, unit testing, and WorkManager.","archived":false,"fork":false,"pushed_at":"2022-10-02T21:41:55.000Z","size":823,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-15T04:57:53.941Z","etag":null,"topics":["android","android-app","android-application","android-studio","architecture-components","clean-architecture","clean-code","gradle","java","java-8","kotlin","modular","modularization","modules","mvvm","viewmodel","workmanager"],"latest_commit_sha":null,"homepage":"","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/MalekKamel.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":"2021-06-17T17:26:33.000Z","updated_at":"2023-03-23T18:55:57.000Z","dependencies_parsed_at":null,"dependency_job_id":"8d28d885-129e-482e-aa07-b3ac36d6cded","html_url":"https://github.com/MalekKamel/Contacts","commit_stats":null,"previous_names":["malekkamel/contacts","shabankamell/contacts"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MalekKamel%2FContacts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MalekKamel%2FContacts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MalekKamel%2FContacts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MalekKamel%2FContacts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MalekKamel","download_url":"https://codeload.github.com/MalekKamel/Contacts/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244976074,"owners_count":20541405,"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-app","android-application","android-studio","architecture-components","clean-architecture","clean-code","gradle","java","java-8","kotlin","modular","modularization","modules","mvvm","viewmodel","workmanager"],"created_at":"2024-11-29T03:16:22.301Z","updated_at":"2026-04-13T23:04:36.071Z","avatar_url":"https://github.com/MalekKamel.png","language":"Kotlin","readme":"# Contacts\n\nContacts app represents a real world app example: it provides a fairly complex set of functionalities,\nit's a suitable showcase for all the advantages that architecture components bring, \nhas all features that would make it a modular, scalable, testable and maintainable app.\n \n## App Logic\n\n- The app displays the list of user’s contacts that are saved in `Room` local database.\n- If there's no data in `Room`, it will be retrieved from contacts `ContentPorvider` and saved locally in `Room`.\n- The local contacts are synchronized with `ContentPorvider` in background every 15 minutes using `WorkManager`.\n- The local contacts are synchronized every time the user opens the app.\n\n## Modular Architecture\n \n\u003cimg src=\"https://github.com/ShabanKamell/Contacts/blob/master/blob/modular-arch-diagram3.png?raw=true\" height=\"600\"\u003e\n  \nThe app is divided into 3 modules under `common` package. Each package has its own responsibilities.\n  \n### Core\n\nCore module contains all shared classes that are visible to all modules. \nHere we put all the code that we need to share with any module in the app.\n\n### Data\n\nData module contains any classes related to the data in the app. \nIt contains network, local database, SharedPreferences, model classes, and any data-related classes.\n\n### Presentation\n\nPresentation modules contains all UI classes\n including view models, base activities, base fragments, custom views, and other common views.\n\n ## Google Architecture Components\n \n The app implements Google architecture components. Visit the [Guide](https://developer.android.com/jetpack/docs/guide) for the details.\n \n \u003cimg src=\"https://github.com/ShabanKamell/Contacts/blob/master/blob/google-architecture-components.png?raw=true\" height=\"500\"\u003e\n\n## Unit Tests\n\nYou can find tests in `app` and `data' modules.\n\n## README\n\nEach module has its own `README.md` file that documents the module responsibilities.\n \n ### Credit\n- [ ] [Build a Modular Android App Architecture (Google I/O'19)](https://www.youtube.com/watch?v=PZBg5DIzNww)\n- [ ] [Plaid](https://github.com/android/plaid)\n\n### 🛡 License\n\u003cdetails\u003e\n    \u003csummary\u003e\n        Click to reveal License\n    \u003c/summary\u003e\n    \n```\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n   http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmalekkamel%2Fcontacts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmalekkamel%2Fcontacts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmalekkamel%2Fcontacts/lists"}