{"id":21082864,"url":"https://github.com/jxareas/goalie","last_synced_at":"2025-05-16T09:32:20.851Z","repository":{"id":64279656,"uuid":"574006765","full_name":"jxareas/Goalie","owner":"jxareas","description":"Live Scores, Lineups \u0026 Stats about the Qatar World Cup 2022 and other Football matches.","archived":false,"fork":false,"pushed_at":"2022-12-13T08:16:44.000Z","size":5834,"stargazers_count":13,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2023-03-08T23:40:07.375Z","etag":null,"topics":["android","football","kotlin","kotlin-coroutines","kotlin-flow","learn","mvvm","repository","retrofit2","webview","webview-app","world-cup","world-cup-2022"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jxareas.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}},"created_at":"2022-12-04T05:38:51.000Z","updated_at":"2023-02-17T08:37:21.000Z","dependencies_parsed_at":"2023-01-15T08:00:39.665Z","dependency_job_id":null,"html_url":"https://github.com/jxareas/Goalie","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jxareas%2FGoalie","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jxareas%2FGoalie/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jxareas%2FGoalie/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jxareas%2FGoalie/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jxareas","download_url":"https://codeload.github.com/jxareas/Goalie/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225419554,"owners_count":17471434,"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","football","kotlin","kotlin-coroutines","kotlin-flow","learn","mvvm","repository","retrofit2","webview","webview-app","world-cup","world-cup-2022"],"created_at":"2024-11-19T20:15:29.671Z","updated_at":"2024-11-19T20:15:30.291Z","avatar_url":"https://github.com/jxareas.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/othneildrew/Best-README-Template\"\u003e\n    \u003cimg src=\"./readme/icon/goalie_logo.svg\" alt=\"Logo\" width=\"80\" height=\"80\"\u003e\n  \u003c/a\u003e\n\n\u003ch1 align = \"center\"\u003e\n\u003cb\u003e\u003ci\u003eGoalie\u003c/i\u003e\u003c/b\u003e\n\u003c/h1\u003e\n\n  \u003cp align=\"center\"\u003e\n    A Football App that provides World Cup Info!\n    \u003cbr /\u003e\n    \u003ca href=\"#-screenshots-\"\u003eScreenshots\u003c/a\u003e\n    ·\n     \u003ca href=\"#-requirements-\"\u003eRequirements\u003c/a\u003e\n    ·\n    \u003ca href=\"#-structure-\"\u003eStructure\u003c/a\u003e\n    ·\n     \u003ca href=\"#-technologies-\"\u003eTechnologies\u003c/a\u003e\n    ·\n    \u003ca href=\"#-license-\"\u003eLicense\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\nGoalie is a Football App which provides an easy and quick access to the most recent world cup matches: with their respective matches, live scores, lineups, stats and recent videos.\n\nThis project is used in order to show how to use webviews in Android, as the widgets provided are embedded via iFrames.\nYou can [**download the .apk debug build by going to the current release**.](https://github.com/jxareas/Goalie/releases/tag/v0.1.0-alpha)\n\n## 📷 Screenshots 📷\n\nThis Project uses [**Material 3**](https://m3.material.io/), the latest version of Google's open source design system known as *Material Design*.\n\n| Match Stats  | Lineup | Live Scores | \n| ------------- | ------------- |  ------------- |\n| ![](./readme/images/world_cup_match_stats.png)  | ![](./readme/images/world_cup_lineup.png)  | ![](./readme/images/live_scores.png)  | \n\n\n| Upcoming Fixtures | Table Standings | Recent Highlights | \n| ------------- | ------------- |  ------------- |\n| ![](./readme/images/world_cup.png)  | ![](./readme/images/table_standings.png)  | ![](./readme/images/videos.png)\n\n## 📝 Requirements 📝\n\nThis project uses the ScoreBat API to provide the aforementioned widgets and videos.\nIn order to run this project, it is necessary to specify the API keys in the `local.properties` file, in the following way:\n```groovy\nSCORE_BAT_TOKEN = \"MY_SCORE_BAT_WIDGET_TOKEN\"\nVIDEO_API_TOKEN = \"MY_SCORE_BAT_VIDEO_API_TOKEN\"\n```\nThese fields are later on read as `BuildConfig` fields in the code and created in the `build.gradle.kts` file from the App Module, as in:\n```kotlin\n// Read SCORE_BAT_TOKEN key from local.properties\nval scoreBatToken: String = gradleLocalProperties(rootDir).getProperty(\"SCORE_BAT_TOKEN\")\nbuildConfigField(\"String\", \"SCORE_BAT_TOKEN\", scoreBatToken)\n// Read VIDEO_API_TOKEN key from local.properties\nval videoApiToken: String = gradleLocalProperties(rootDir).getProperty(\"VIDEO_API_TOKEN\")\nbuildConfigField(\"String\", \"VIDEO_API_TOKEN\", videoApiToken)\n```\n\nFor more information, you can [create an account](https://www.scorebat.com/account/) in the Website.\n\n## 📁 Structure 📁\n\nThe structure of this project is simple, and tries to follow the Google-recommended MVVM (when required), as exemplified by the following diagram:\n\n![](./readme/images/MVVM.png)\n\n## 🚀 Technologies 🚀\n\nThis project uses many popular libraries and tools in the Android ecosystem:\n\n* **Dagger Hilt**: A fully static, compile-time dependency injection framework for both Java and Android.\n* **OkHttp**: Square’s meticulous HTTP client for the JVM, Android, and GraalVM.\n* **Retrofit**: A type-safe HTTP client.\n* **Kotlin Coroutines**: Managing background threads with simplified code and reducing needs for callbacks.\n* **Kotlin Flow**: Cold asynchronous data stream that sequentially emits values\n* **Jetpack Navigation**: Implement navigation and transactions between fragments.\n* **Moshi**: Converts data used by an application to a format that can be transferred over a network or stored in a database or a file.\n* **DiffUtil:**  Improving RecyclerView's performance when handling list updates.\n* **Lifecycle**: Perform actions in response to a change in the lifecycle status of another component.\n* **ViewModel**: Designed to manage and store UI related data in a lifecycle conscious way.\n* **Coil**:An image loading library for Android backed by Kotlin Coroutines.\n* **ViewBinding**: Allows you to more easily write code that interacts with views.\n* **Material 3**: The latest version of Material Design, introduced in Android 12.\n* **Shimmer**: Provides an easy way to add a shimmer effect to any view in your Android app.\n* **Splash Screen API**: Provides a launch animation for all apps when running on a device with Android 12 or higher. \n* **Material Motion**: A set of transition patterns that can help users understand and navigate an app.\n\n\n\n## 🪶 Author(s) 🪶\n\n**Jon Areas**, [*@jxareas*](https://github.com/jxareas).\n\n## 📜 License 📜\n\n```\nCopyright (c) 2022 Jonathan Areas\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nNotwithstanding the foregoing, you may not use, copy, modify, merge, publish,\ndistribute, sublicense, create a derivative work, and/or sell copies of the\nSoftware in any work that is designed, intended, or marketed for pedagogical or\ninstructional purposes related to programming, coding, application development,\nor information technology.  Permission for such use, copying, modification,\nmerger, publication, distribution, sublicensing, creation of derivative works,\nor sale is expressly withheld.\n\nThis project and source code may use libraries or frameworks that are\nreleased under various Open-Source licenses. Use of those libraries and\nframeworks are governed by their own individual licenses.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjxareas%2Fgoalie","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjxareas%2Fgoalie","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjxareas%2Fgoalie/lists"}