{"id":13610040,"url":"https://github.com/igorescodro/alkaa","last_synced_at":"2025-05-14T15:06:39.179Z","repository":{"id":37602096,"uuid":"116942964","full_name":"igorescodro/alkaa","owner":"igorescodro","description":"Kotlin multiplatform app to manage your tasks","archived":false,"fork":false,"pushed_at":"2025-05-06T19:35:26.000Z","size":5396,"stargazers_count":1440,"open_issues_count":10,"forks_count":146,"subscribers_count":20,"default_branch":"main","last_synced_at":"2025-05-06T20:22:04.583Z","etag":null,"topics":["android","android-testing","clean-architecture","compose-ios","compose-multiplatform","coroutines-android","dynamic-delivery","hexagonal-architecture","ios","jetpack-compose","kmp","kotlin","kotlin-multiplatform","kotlin-multiplatform-mobile","kotlin-multiplatform-sample","modularization"],"latest_commit_sha":null,"homepage":"https://play.google.com/store/apps/details?id=com.escodro.alkaa","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/igorescodro.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}},"created_at":"2018-01-10T10:29:14.000Z","updated_at":"2025-05-06T19:34:14.000Z","dependencies_parsed_at":"2024-05-19T22:22:29.420Z","dependency_job_id":"a713316d-ae31-4552-abe6-15ced75e203b","html_url":"https://github.com/igorescodro/alkaa","commit_stats":null,"previous_names":[],"tags_count":49,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igorescodro%2Falkaa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igorescodro%2Falkaa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igorescodro%2Falkaa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igorescodro%2Falkaa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/igorescodro","download_url":"https://codeload.github.com/igorescodro/alkaa/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254169085,"owners_count":22026208,"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-testing","clean-architecture","compose-ios","compose-multiplatform","coroutines-android","dynamic-delivery","hexagonal-architecture","ios","jetpack-compose","kmp","kotlin","kotlin-multiplatform","kotlin-multiplatform-mobile","kotlin-multiplatform-sample","modularization"],"created_at":"2024-08-01T19:01:40.600Z","updated_at":"2025-05-14T15:06:39.139Z","avatar_url":"https://github.com/igorescodro.png","language":"Kotlin","readme":"![build](https://github.com/igorescodro/alkaa/actions/workflows/build.yml/badge.svg)\n[![UI Tests](https://github.com/igorescodro/alkaa/actions/workflows/instrumented_tests.yml/badge.svg)](https://github.com/igorescodro/alkaa/actions/workflows/instrumented_tests.yml)\n[![codebeat badge](https://codebeat.co/badges/5dce2515-5fa7-4885-bfab-2a2905d84ee5)](https://codebeat.co/projects/github-com-igorescodro-alkaa-main)\n[![CodeFactor](https://www.codefactor.io/repository/github/igorescodro/alkaa/badge/main)](https://www.codefactor.io/repository/github/igorescodro/alkaa/overview/main)\n[![Codacy Badge](https://api.codacy.com/project/badge/Grade/d88ab7250f1a4e9fb0a96dec11a0c2cd)](https://www.codacy.com/manual/igorescodro/alkaa?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=igorescodro/alkaa\u0026amp;utm_campaign=Badge_Grade)\n\u003ca href=\"https://ktlint.github.io/\"\u003e\u003cimg src=\"https://img.shields.io/badge/code%20style-%E2%9D%A4-FF4081.svg\" alt=\"ktlint\"\u003e\u003c/a\u003e\n\n\u003cimg src=\"app/src/main/ic_launcher-web.png\" width=\"200\"\u003e\n\n# Alkaa 3.0 - Multiplatform\n\nAlkaa (_begin_, _start_ in Finnish) is a to-do application project to study the latest components,\narchitecture and tools for Android development. The project evolved a lot since the beginning is\navailable on Google Play and App Store! ❤️\n\nThe current version of Alkaa was completely migrate to **Kotlin and Compose Multiplatform**!\n\n## Android\n| \u003cimg src=\"https://play-lh.googleusercontent.com/W76J3O4OvtqiBvGePEL2Czt_Jl52SIcm38SK2m7Jzbq83RdzvDStd1Qn5NoAp3ffEibn=w5120-h2880-rw\"\u003e  | \u003cimg src=\"https://play-lh.googleusercontent.com/CRRgxRGMLXykBlehra9LNOmCedbAhRjAEbU5QFx0hTXpE6m4P6YXoRv78rd5T22-LEA=w5120-h2880-rw\"\u003e | \u003cimg src=\"https://play-lh.googleusercontent.com/XYlsapSwCTNFPNZmFRI9-e5Joc9h5ZprpU8X_eA8Gpcwm2E2ZLOWc7kNi028UoZR0N8=w5120-h2880-rw\"\u003e  | \u003cimg src=\"https://play-lh.googleusercontent.com/XBjXPeuFkG_lhrbH392LD_wACYpPx69aRP4W2h2oxlvmDYwXDK2ZSEQXGl6pyo-jTfaX=w5120-h2880-rw\"\u003e |\n| ------------- | ------------- | ------------- | ------------- |\n\n## iOS\n| \u003cimg src=\"https://is1-ssl.mzstatic.com/image/thumb/PurpleSource126/v4/e6/6e/e4/e66ee445-cbaa-17c3-6f63-fef2b62ca0e0/87c54b1b-49d4-4555-8071-60a39f15dbb0_01.png/460x0w.webp\"\u003e | \u003cimg src=\"https://is1-ssl.mzstatic.com/image/thumb/PurpleSource126/v4/a2/82/5f/a2825f13-1da8-aedc-f708-517c2cc2913b/3733dbf1-1844-408f-a947-9250267c608b_02.png/460x0w.png\"\u003e  | \u003cimg src=\"https://is1-ssl.mzstatic.com/image/thumb/PurpleSource116/v4/cd/cd/b2/cdcdb2fa-8835-0f21-310b-c59e21fbbfbe/d16b3c35-5885-4f00-b7e6-045b09bb3809_03.png/460x0w.webp\"\u003e | \u003cimg src=\"https://is1-ssl.mzstatic.com/image/thumb/PurpleSource116/v4/79/6b/3f/796b3f9b-2141-bdd8-0583-c0df856c3b26/dc6cf806-a9cc-4b5d-9643-711e2f88da65_04.png/460x0w.png\"\u003e |\n| ------------- | ------------- | ------------- | ------------- |\n\n## 📦 Download\n\n\n\u003ctable style=\"width:100%\"\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003ca href='https://play.google.com/store/apps/details?id=com.escodro.alkaa'\u003e\u003cimg alt='Get it on Google Play' src='https://play.google.com/intl/en_us/badges/images/generic/en_badge_web_generic.png' width=240/\u003e\u003c/a\u003e\n    \u003ctd\u003e\u003ca href='https://apps.apple.com/ca/app/alkaa/id6476208968'\u003e\u003cimg alt='Download in the App Store' src='https://developer.apple.com/assets/elements/badges/download-on-the-app-store.svg' width=180/\u003e\u003c/a\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\n## 📚 Tech stack\n\nOne of the main goals of Alkaa is too use all the latest libraries and tools available.\n\n### 🧑🏻‍💻 Multiplatform development\n\n- Application entirely written in [Kotlin](https://kotlinlang.org)\n- UI developed in [Compose Multiplatform](https://www.jetbrains.com/lp/compose-multiplatform/)\n- UI Tests with [Compose Multiplatform UI Testing](https://www.jetbrains.com/help/kotlin-multiplatform-dev/compose-test.html)\n- Following the [Material You](https://m3.material.io/) guidelines and dynamic color (Android only)\n- Asynchronous processing using [Coroutines](https://kotlin.github.io/kotlinx.coroutines/)\n- [Dynamic delivery](https://developer.android.com/guide/playcore/feature-delivery) for the _Task\n  Tracker_ feature\n- Widgets using [Jetpack Glance](https://developer.android.com/jetpack/androidx/releases/glance)\n- Dependency injection with [Koin](https://insert-koin.io)\n- Database using [SQLDelight](https://github.com/cashapp/sqldelight)\n\nFor more dependencies used in project, please access the\n[Dependency File](https://github.com/igorescodro/alkaa/blob/main/gradle/libs.versions.toml)\n\nIf you want to check the previous version of Alkaa, please take a look at\nthe latest [V1](https://github.com/igorescodro/alkaa/tree/v1.7.0) or [V2](https://github.com/igorescodro/alkaa/tree/v2.3.0) releases.\n\n### 🧪 Quality\n\n- [klint](https://github.com/shyiko/ktlint)\n- [detekt](https://github.com/arturbosch/detekt)\n- [compose-rules](https://github.com/twitter/compose-rules)\n- [lint](https://developer.android.com/studio/write/lint)\n- [codebeat](https://codebeat.co)\n- [CodeFactor](https://www.codefactor.io/)\n- [Codacy](http://codacy.com)\n\n## 🏛 Architecture\n\nAlkaa architecture is strongly based on\nthe [Hexagonal Architecture](https://alistair.cockburn.us/hexagonal-architecture/) by Alistair\nCockburn. The application also relies heavily in modularization for better separation of concerns\nand encapsulation.\n\nLet's take a look in each major module of the application:\n\n* **app** and **ios-app** - The platform-specific app module. It contains all the initialization logic for each platform.\n* **features** - The module/folder containing all the features (visual or not) from the application\n* **domain** - The modules containing the most important part of the application: the business\n  logic. This module depends only on itself and all interaction it does is via _dependency\n  inversion_.\n* **data** - The module containing the data (local, remote, light etc) from the app.\n* **libraries** - The module with useful small libraries for the project, such as design system,\n* navigation, test etc.\n\nThis type of architecture protects the most important modules in the app. To achieve this, all the\ndependency points to the center, and the modules are organized in a way that\n_the more the module is in the center, more important it is_.\n\nTo better represents the idea behind the modules, here is a architecture image representing the flow\nof dependency:\n\n![Alkaa Architecture](assets/alkaa-arch-3-0.png)\n\n## 📃 License\n\n```\nCopyright 2018 Igor Escodro\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":["Miscellaneous","Kotlin",":art: Pattern"],"sub_categories":["MVVM"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Figorescodro%2Falkaa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Figorescodro%2Falkaa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Figorescodro%2Falkaa/lists"}