Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/igorescodro/alkaa
Kotlin multiplatform app to manage your tasks
https://github.com/igorescodro/alkaa
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
Last synced: 3 days ago
JSON representation
Kotlin multiplatform app to manage your tasks
- Host: GitHub
- URL: https://github.com/igorescodro/alkaa
- Owner: igorescodro
- License: apache-2.0
- Created: 2018-01-10T10:29:14.000Z (about 7 years ago)
- Default Branch: main
- Last Pushed: 2024-10-28T11:52:23.000Z (3 months ago)
- Last Synced: 2024-10-29T15:40:12.144Z (3 months ago)
- 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
- Language: Kotlin
- Homepage: https://play.google.com/store/apps/details?id=com.escodro.alkaa
- Size: 4.64 MB
- Stars: 1,323
- Watchers: 18
- Forks: 130
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-list - igorescodro/alkaa - Kotlin multiplatform app to manage your tasks (Kotlin)
- awesome-compose - Alkaa - Open-source app to manage your tasks quickly and easily (Miscellaneous)
- awesome-android-kotlin-apps - alkaa - source app to manage your tasks quickly and easily</br></br> <b>Tech Stack</b> : Koin, Espresso, UiAutomator, Mockk, Coroutines, Navigation, Room, MotionLayout, KTX, Modularization, Dynamic Delivery, Dark Theme, klint, Detekt, codebeat, CodeFactor, Codacy, MPAndroidChart, Groupie, LiveData, ViewModel </br></br> <i> Last commit: 5 hours ago</i> | 🌟 1057 </br> 🍴 114 </br> 👁️ 18 | (:art: Pattern / MVVM)
README
[](https://github.com/igorescodro/alkaa/actions/workflows/instrumented_tests.yml)
[](https://codebeat.co/projects/github-com-igorescodro-alkaa-main)
[](https://www.codefactor.io/repository/github/igorescodro/alkaa/overview/main)
[](https://www.codacy.com/manual/igorescodro/alkaa?utm_source=github.com&utm_medium=referral&utm_content=igorescodro/alkaa&utm_campaign=Badge_Grade)
# Alkaa 3.0 - Multiplatform
Alkaa (_begin_, _start_ in Finnish) is a to-do application project to study the latest components,
architecture and tools for Android development. The project evolved a lot since the beginning is
available on Google Play and App Store! ❤️
The current version of Alkaa was completely migrate to **Kotlin and Compose Multiplatform**!
## Android
| 
| 
| 
| 
|
| ------------- | ------------- | ------------- | ------------- |
## iOS
| 
| 
| 
| 
|
| ------------- | ------------- | ------------- | ------------- |
## 📦 Download
## 📚 Tech stack
One of the main goals of Alkaa is too use all the latest libraries and tools available.
### 🧑🏻💻 Multiplatform development
- Application entirely written in [Kotlin](https://kotlinlang.org)
- UI developed in [Compose Multiplatform](https://www.jetbrains.com/lp/compose-multiplatform/)
- UI Tests with [Compose Multiplatform UI Testing](https://www.jetbrains.com/help/kotlin-multiplatform-dev/compose-test.html)
- Following the [Material You](https://m3.material.io/) guidelines and dynamic color (Android only)
- Asynchronous processing using [Coroutines](https://kotlin.github.io/kotlinx.coroutines/)
- [Dynamic delivery](https://developer.android.com/guide/playcore/feature-delivery) for the _Task
Tracker_ feature
- Widgets using [Jetpack Glance](https://developer.android.com/jetpack/androidx/releases/glance)
- Dependency injection with [Koin](https://insert-koin.io)
- Database using [SQLDelight](https://github.com/cashapp/sqldelight)
For more dependencies used in project, please access the
[Dependency File](https://github.com/igorescodro/alkaa/blob/main/gradle/libs.versions.toml)
If you want to check the previous version of Alkaa, please take a look at
the latest [V1](https://github.com/igorescodro/alkaa/tree/v1.7.0) or [V2](https://github.com/igorescodro/alkaa/tree/v2.3.0) releases.
### 🧪 Quality
- [klint](https://github.com/shyiko/ktlint)
- [detekt](https://github.com/arturbosch/detekt)
- [compose-rules](https://github.com/twitter/compose-rules)
- [lint](https://developer.android.com/studio/write/lint)
- [codebeat](https://codebeat.co)
- [CodeFactor](https://www.codefactor.io/)
- [Codacy](http://codacy.com)
## 🏛 Architecture
Alkaa architecture is strongly based on
the [Hexagonal Architecture](https://alistair.cockburn.us/hexagonal-architecture/) by Alistair
Cockburn. The application also relies heavily in modularization for better separation of concerns
and encapsulation.
Let's take a look in each major module of the application:
* **app** and **ios-app** - The platform-specific app module. It contains all the initialization logic for each platform.
* **features** - The module/folder containing all the features (visual or not) from the application
* **domain** - The modules containing the most important part of the application: the business
logic. This module depends only on itself and all interaction it does is via _dependency
inversion_.
* **data** - The module containing the data (local, remote, light etc) from the app.
* **libraries** - The module with useful small libraries for the project, such as design system,
* navigation, test etc.
This type of architecture protects the most important modules in the app. To achieve this, all the
dependency points to the center, and the modules are organized in a way that
_the more the module is in the center, more important it is_.
To better represents the idea behind the modules, here is a architecture image representing the flow
of dependency:
## 📃 License
```
Copyright 2018 Igor Escodro
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```