WIP Update README for iOS Target

Author: opatry

README.md

@@ -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`)
+  - Written in Swift as an Xcode project
 - [`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,54 @@ 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
 
 ```