{"id":21922950,"url":"https://github.com/prof18/filmatic","last_synced_at":"2025-09-07T22:37:16.375Z","repository":{"id":71272938,"uuid":"189304492","full_name":"prof18/Filmatic","owner":"prof18","description":"Filmatic shows you some popular movies of the moment. The project is a playground application that I use to catch up with modern Android development. In particular, I've used it to learn modularization and Dependency Injection with Dagger and then Hilt.","archived":false,"fork":false,"pushed_at":"2025-04-10T06:00:39.000Z","size":1397,"stargazers_count":16,"open_issues_count":11,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-19T18:21:23.896Z","etag":null,"topics":["android","clean-architecture","hilt","modularization","mvvm"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/prof18.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-05-29T21:56:27.000Z","updated_at":"2025-04-09T10:14:16.000Z","dependencies_parsed_at":"2024-02-07T22:28:25.767Z","dependency_job_id":"d5be1631-0451-4e24-8311-e9ca25f1ea25","html_url":"https://github.com/prof18/Filmatic","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/prof18/Filmatic","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prof18%2FFilmatic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prof18%2FFilmatic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prof18%2FFilmatic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prof18%2FFilmatic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/prof18","download_url":"https://codeload.github.com/prof18/Filmatic/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prof18%2FFilmatic/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274107692,"owners_count":25223451,"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","status":"online","status_checked_at":"2025-09-07T02:00:09.463Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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","clean-architecture","hilt","modularization","mvvm"],"created_at":"2024-11-28T21:08:06.241Z","updated_at":"2025-09-07T22:37:16.342Z","avatar_url":"https://github.com/prof18.png","language":"Kotlin","readme":"# Filmatic\n\nFilmatic shows you some popular movies of the moment. The project is a playground application that I use \nto catch up with modern Android development. In particular, I've used it to learn modularization and \nDependency Injection with [Dagger](https://dagger.dev/) and then [Hilt](https://dagger.dev/hilt/).\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"img/filmatic-ui.png\"\u003e\n\u003c/div\u003e\n\n## Modular Architecture 🧩\n\nAs mentioned, the app uses a multi-modular project structure. A module can be of 3 different types:\n\n- Library module\n- Feature module\n- App Module\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"img/modules-arch.jpeg\"\u003e\n\u003c/div\u003e\n\nA **library module** can be an Android or a pure Kotlin module. A library module never depends on a feature or an app module, \nbut it can depend on another library. Library modules can contain different functionalities, for example \nUI components, data storage, networking, analytics, etc.\n\nA **feature module** is an Android library that contains a specific feature of the app. For example,\nthe onboarding flow, the home screen, the settings, etc. A feature module never depends on other feature modules \nor on an app module. However, it depends on many libraries module\n\nThe **app module** is an Android Application and it links all the modules together. For that reason it \ndepends on other feature and library modules.\n\nFilmatic is composed of different feature and library modules:\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"img/modules.jpg\"\u003e\n\u003c/div\u003e\n\n- **App module** -\u003e wraps all the modules together and decides which activity to start\n- **buildSrc**  -\u003e contains the definitions of the dependencies used in the project\n- **core**      -\u003e contains common code used around the app, plus the localized strings.\n- **Feature modules**: \n    - **about** -\u003e contains the code for the about screen\n    - **home**  -\u003e contains the code for the home screen\n- **Library modules**:\n    - **navigation**    -\u003e handles navigation between different feature modules. The navigation is handled with implicit intents\n    - **preferences**   -\u003e retrieve and store data from shared preferences\n    - **test-shared**   -\u003e contains common test utilities used in different feature modules\n    - **ui-components** -\u003e contains the UI components used in the app, plus style, colors and common drawables\n   \n\n## Feature module architecture 🏗\n\nEvery feature module is structured using Clean Architecture, with [data](https://github.com/prof18/Filmatic/tree/master/features/home/src/main/java/com/prof18/filmatic/features/home/data),\n[domain](https://github.com/prof18/Filmatic/tree/master/features/home/src/main/java/com/prof18/filmatic/features/home/domain)\nand [presentation](https://github.com/prof18/Filmatic/tree/master/features/home/src/main/java/com/prof18/filmatic/features/home/presentation) layers.  \n\nDependency Injection is managed with [Hilt](https://dagger.dev/hilt/).\n\n## Automations 🤖\n\nThe projects is using [**detekt**](https://github.com/detekt/detekt) for formatting and static analysis.\n\nThere is also a GitHub Action, named [Code Checks](https://github.com/prof18/Filmatic/blob/master/.github/workflows/checks.yaml) that builds and runs the `check` gradle task. \n\n## Build and Run 💻\n\nTo build and run the app, you have to set a secret in your local.properties file, for the TMDB API.\n\n```\ntmdbKey=YOUR_SECRET_API_KEY\n```\n\nOr as an alternative, you can set it as system environment variables: `TMDB_KEY`\n\nN.B. The system environment variable is mandatory to make the CI work.\n\n## License\n\n```\n   Copyright 2019-2021 Marco Gomiero\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","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprof18%2Ffilmatic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprof18%2Ffilmatic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprof18%2Ffilmatic/lists"}