{"id":19495449,"url":"https://github.com/guilhe/expressus","last_synced_at":"2025-04-06T09:11:28.585Z","repository":{"id":38410418,"uuid":"483274962","full_name":"GuilhE/Expressus","owner":"GuilhE","description":"Kotlin Multiplatform Coffee Machine","archived":false,"fork":false,"pushed_at":"2024-10-20T21:56:19.000Z","size":14087,"stargazers_count":110,"open_issues_count":0,"forks_count":10,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-10-21T02:16:11.581Z","etag":null,"topics":["android","compose","compose-multiplatform","finite-state-machine","ios","jetpack-compose","kotlin","kotlin-multiplatform","kotlin-multiplatform-mobile","model-view-intent","swift","swiftui","ui-state-management"],"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/GuilhE.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}},"created_at":"2022-04-19T14:12:38.000Z","updated_at":"2024-10-20T21:56:23.000Z","dependencies_parsed_at":"2023-01-23T06:00:59.748Z","dependency_job_id":"2635cafc-cbe7-4c3b-9f08-6a18717f95f6","html_url":"https://github.com/GuilhE/Expressus","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GuilhE%2FExpressus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GuilhE%2FExpressus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GuilhE%2FExpressus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GuilhE%2FExpressus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GuilhE","download_url":"https://codeload.github.com/GuilhE/Expressus/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247457803,"owners_count":20941906,"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","compose","compose-multiplatform","finite-state-machine","ios","jetpack-compose","kotlin","kotlin-multiplatform","kotlin-multiplatform-mobile","model-view-intent","swift","swiftui","ui-state-management"],"created_at":"2024-11-10T21:37:49.657Z","updated_at":"2025-04-06T09:11:28.563Z","avatar_url":"https://github.com/GuilhE.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"/media/icon.png\" width=\"100\" align=\"right\"\u003e\u003c/br\u003e\u003c/br\u003e\n\n# Expressus\n\n[![Featured in Kotlin Weekly - Issue #299](https://img.shields.io/badge/Featured_in_Kotlin_Weekly-Issue_%23299-7878b4)](https://mailchi.mp/kotlinweekly/kotlin-weekly-299) [![Featured in Kotlin Weekly - Issue #301](https://img.shields.io/badge/Featured_in_Kotlin_Weekly-Issue_%23301-7878b4)](https://mailchi.mp/kotlinweekly/kotlin-weekly-301) [![Android Weekly](https://androidweekly.net/issues/issue-515/badge)](https://androidweekly.net/issues/issue-515) [![Android Weekly](https://androidweekly.net/issues/issue-583/badge)](https://androidweekly.net/issues/issue-583) \u003ca href=\"https://jetc.dev/issues/177.html\"\u003e\u003cimg src=\"https://img.shields.io/badge/As_Seen_In-jetc.dev_Newsletter_Issue_%23177-blue?logo=Jetpack+Compose\u0026amp;logoColor=white\" alt=\"As Seen In - jetc.dev Newsletter Issue #177\"\u003e\u003c/a\u003e\n\nKMP sample project acting as a playground to illustrate what's discussed in these articles:\n\u003cp\u003e\n \u003ca href=\"https://guidelgado.medium.com/36d84056c616\"\u003e\u003cimg src=\"/media/b1.png\" width=\"692\"\u003e\u003c/a\u003e\u003c/br\u003e\n \u003ca href=\"https://guidelgado.medium.com/a67bd9a49882\"\u003e\u003cimg src=\"/media/b2.png\" width=\"692\"\u003e\u003c/a\u003e\u003c/br\u003e\n \u003ca href=\"https://guidelgado.medium.com/45d37effeda9\"\u003e\u003cimg src=\"/media/b3.png\" width=\"692\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## Details\n\n### Modules\n\n#### Shared\n\n- Model-View-Intent architecture\n- Finite State Machine to validate state transitions\n- State restoration (both for UI State and FSM State)\n\n#### Shared Ui Compose\n\n- Compose Multiplatform to share composables between Desktop, Android and iOS\n\n### Platforms\n\n#### Mobile\n\n- UI State emissions using Kotlin Flow and Swift Combine Publisher\n- Jetpack Compose, Compose Multiplatform and SwiftUI\n\n`./gradlew :androidApp:installDebug`\n\nTo run iosApp open `iosApp/Expressus.xcworkspace` in Xcode.\n\n\u003e[!NOTE]\n\u003e Due to this [issue](https://github.com/JetBrains/compose-multiplatform/issues/4720#issuecomment-2100898893) you must first run the following steps:\n\u003e 1. run `./gradlew clean`\n\u003e 2. run build project in Xcode\n\u003e 3. run `./gradlew generateDummyFramework`\n\u003e 4. `cd ./iosApp` and run `pod install`\n\u003e 5. run standard configuration.\n\n#### Desktop\n\n- UI State emissions using Kotlin Flow\n- Compose Multiplatform\n\n`./gradlew :desktopApp:run`\n\n## Outputs\n\n### UI\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://user-images.githubusercontent.com/2677139/167465046-1226fa4f-8ddf-4c3d-bd0e-8f0051cac4c0.mp4\"\u003e\u003cimg src=\"/media/ui-android.png\" height=\"500\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://user-images.githubusercontent.com/2677139/167465066-8b88f998-e327-4b11-9986-98b647be4e47.mov\"\u003e\u003cimg src=\"/media/ui-ios.png\" height=\"500\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github-production-user-asset-6210df.s3.amazonaws.com/2677139/260028987-5196cebe-ce9f-4c36-b9d4-d8dc19e9071d.mp4\"\u003e\u003cimg src=\"/media/ui-ios-compose.png\" height=\"500\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://user-images.githubusercontent.com/2677139/167465082-1cce53d8-0fc2-4125-a341-7daf9741c067.mov\"\u003e\u003cimg src=\"/media/ui-desktop.png\" height=\"500\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n### FSM + MVI\n\n\u003cp align=\"center\"\u003e\n \u003cimg src=\"/media/fsm-android.gif\" width=\"390\"\u003e  \u003cimg src=\"/media/fsm-ios.gif\" width=\"430\"\u003e   \n\u003c/p\u003e\n\u003cp align=\"center\"\u003eClick on each image for full resolution\u003c/p\u003e\n\n## LICENSE\n\nCopyright (c) 2022-present GuilhE\n\nLicensed 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\nof the License at\n\n\u003chttp://www.apache.org/licenses/LICENSE-2.0\u003e\n\nUnless required by applicable law or agreed to in writing, software distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT\nWARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under\nthe License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguilhe%2Fexpressus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fguilhe%2Fexpressus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguilhe%2Fexpressus/lists"}