WIP Update README for iOS Target

Author: opatry

README.md

@@ -9,7 +9,7 @@
 
 The coverage report excludes code not intended to be covered.
 
-This avoids the [“broken window” effect](https://blog.codinghorror.com/the-broken-window-theory/): whether coverage is at 43% or 56%, it’s perceived as equally low—so efforts to improve it are often dismissed. In contrast, high or near-100% coverage is seen as achievable and worth tracking.
+This avoids the [“broken window” effect](https://blog.codinghorror.com/the-broken-window-theory/): whether coverage is at 43% or 56%, it's perceived as equally low—so efforts to improve it are often dismissed. In contrast, high or near-100% coverage is seen as achievable and worth tracking.
 
 Refer to the root project's [`build.gradle.kts`](build.gradle.kts#L55-L90) for details.
 
@@ -38,7 +38,7 @@ Refer to the root project's [`build.gradle.kts`](build.gradle.kts#L55-L90) for d
 
 > [!INFO] The application is also available as a desktop (Jvm) application and an iOS application as well (using [Compose Multi Platform (aka CMP)](https://www.jetbrains.com/compose-multiplatform/) as UI Toolkit).
 
-> I set out to revisit the classical TODO app, ‘local-first’ syncing with Google Tasks—aiming for an <abbr title="Minimum Viable Experience">MVE</abbr> in 2 weeks, focusing on the 80/20 rule to nail the essentials.
+> I set out to revisit the classical TODO app, ‘local-first' syncing with Google Tasks—aiming for an <abbr title="Minimum Viable Experience">MVE</abbr> in 2 weeks, focusing on the 80/20 rule to nail the essentials.
 
 | ![](assets/screens/task_lists_light.png) | ![](assets/screens/groceries_light.png) | ![](assets/screens/add_task_light.png) | ![](assets/screens/home_dark.png)  |
 | --------------------------------------- |--------------------------------------- | ---------------------------------- | ---------------------------------- |
@@ -78,8 +78,9 @@ I do not aim to implement advanced features beyond what is supported by the Goog
 
 ## 🛠️ Tech stack
 
-- [Kotlin](https://kotlinlang.org/), [Multiplatform (aka KMP)](https://kotlinlang.org/docs/multiplatform.html) (currently Desktop & Android are supported)
-  - iOS wasn’t initially planned, but a draft version is available (use it at your own risks, bare minimum support is expected). It uses [Compose Multi Platform (aka CMP)](https://www.jetbrains.com/compose-multiplatform/).
+- [Kotlin](https://kotlinlang.org/), [Multiplatform (aka KMP)](https://kotlinlang.org/docs/multiplatform.html)
+  - Android and Desktop are fully supported.
+  - iOS wasn't initially planned, but a draft version is available (use it at your own risks, there might be dragons 🐉).
   - Web is not planned any time soon (contribution are welcome 🤝)
 - [Kotlin coroutines](https://kotlinlang.org/docs/reference/coroutines/coroutines-guide.html)
 - [Ktor client](https://ktor.io/) (+ [Kotlinx serialization](https://kotlinlang.org/docs/serialization.html))
@@ -125,32 +126,13 @@ I do not aim to implement advanced features beyond what is supported by the Goog
   - The Desktop application (thin layer fully reusing `:tasks-app-shared`)
 - [`:tasks-app-android`](tasks-app-android) <span style="color: #66FF00;">■■■■■■■■</span>□□ 80%
   - The Android application (thin layer fully reusing `:tasks-app-shared`)
+- [`:tasks-app-ios/Taskfolio`](tasks-app-ios/Taskfolio) <span style="color: #33FF00;">■■■■■■■■■</span>□ 90%
+  - The iOS application (thin layer fully reusing `:tasks-app-shared`)
+  - Xcode project, written in Swift
 - [`website/`](website) <span style="color: #00FF00;">■■■■■■■■■■</span> 100%
   - The [static site](https://opatry.github.io/taskfolio/) presenting the project
   - Made with [Jekyll](https://jekyllrb.com/) and served by [Github pages](https://pages.github.com/)
 
-## XXX iOS
-
-Dev environment initial setup (cf. https://touchlab.co/xcodekotlin):
-```bash
-brew install xcode-kotlin
-xcode-kotlin install
-```
-
-Sync after Xcode update:
-```bash
-xcode-kotlin sync
-```
-
-Build native `tasks-app-shared` code as iOS XCFramework: 
-```bash
-./gradlew tasks-app-shared:linkDebugFrameworkIosSimulatorArm64
-./gradlew tasks-app-shared:embedAndSignAppleFrameworkForXcode
-```
-
-Either commit (but what?) or explain how to debug with Add Group > Add folders `tasks-app-shared/{commonMain,iosMain}`.
-cf. https://touchlab.co/xcodekotlin
-
 ## 🧑‍💻 Local development
 
 <details>
@@ -187,6 +169,58 @@ When clicking on it, it will open a new window with the hot reload status.
 ![](assets/compose-hot-reload-console.png)
 </details>
 
+## 🍎 Build for iOS target
+
+The support of iOS works more or less _as-is_ and gets the job done. It's provided without guarantees, use at your own risk.  
+Feedback and contributions are welcome though 🤝.
+
+<details>
+<summary>See details…</summary>
+
+> [!INFO] iOS support is _opt-in_ and disabled by default to avoid unnecessary time and disk usage during the initial Gradle sync when the iOS target isn't required.  
+> You can enable it by setting `ios.target` Gradle property to `all`, `simulator` or `device` from either `local.properties` or CLI using `-P`.  
+> When building from Xcode, it automatically sets `-Pios.target=simulator` based on `Config.xcconfig`.
+
+You can build the `:tasks-app-shared` code for iOS using Gradle (to check if evertyhing compiles on Kotlin side):
+
+```bash
+./gradlew tasks-app-shared:linkDebugFrameworkIosSimulatorArm64 -Pios.target=simulator
+```
+
+For full XCFramework build (to be consumed by the iOS application), you'll have to rely on `xcodebuild` (or build directly from Xcode):
+
+```bash
+cd tasks-app-ios
+IOS_TARGET=simulator xcodebuild -project Taskfolio.xcodeproj \
+  -scheme Taskfolio \
+  -sdk iphonesimulator \
+  -arch arm64 \
+  -configuration Debug \
+  build \
+  CODE_SIGNING_ALLOWED=NO \
+  CODE_SIGN_IDENTITY="" \
+  CODE_SIGNING_REQUIRED=NO
+```
+This triggers the `:tasks-app-shared:embedAndSignAppleFrameworkForXcode` Gradle task under the hood.
+
+For Xcode integration, it's recommended to install the [Xcode Kotlin plugin](https://touchlab.co/xcodekotlin):
+
+```bash
+brew install xcode-kotlin
+xcode-kotlin install
+```
+
+When you update Xcode, you'll have to sync the plugin:
+
+```bash
+xcode-kotlin sync
+```
+
+If you want to debug the Kotlin code from Xcode, you'll have to add the needed source sets in Xcode:  
+Add Group > Add folders as **reference** > `tasks-app-shared/{commonMain,iosMain}` (or any other module you want to debug).
+If you properly installed the Xcode Kotlin plugin, you'll be able to set a breakpoint in the Kotlin code and see syntax coloring as well.
+</details>
+
 ## ⚖️ License
 
 ```