Add documentation page for iOS dev apps (#3244)

docs/mdbook/src/SUMMARY.md

@@ -16,6 +16,7 @@
   - [Tests](ios/ios-tests.md)
   - [Documentation](ios/ios-documentation.md)
   - [Release](ios/release.md)
+  - [Development Apps](ios/dev-apps.md)
 
 - [Design](./design/README.md)
   - [Ten Thousand Foot View](design/ten-thousand-foot-view.md)

docs/mdbook/src/ios/dev-apps.md

@@ -0,0 +1,37 @@
+# Development Apps
+
+There are two iOS apps available in the repo that you can use for MapLibre Native development. One Objective-C based app and a Swift based app.
+
+## Objective-C App
+
+This app is available as "App" in the [generated Xcode project](./README.md).
+
+The source code lives in `platform/ios/app`.
+
+You can also build and run it from the command line with:
+
+```
+bazel run --//:renderer=metal //platform/ios:App
+```
+
+<p align="center">
+  <img width="300" alt="Objective-C app screenshot" src="https://github.com/user-attachments/assets/aeb0cb5e-1f6c-439e-8668-22ee0a0b11f2" />
+</p>
+
+## Swift App
+
+The Swift App is mainly used to demo usage patterns in the [example documentation](./ios-documentation.md#examples).
+
+This app is available as "MapLibreApp" in the [generated Xcode project](./README.md).
+
+The source code lives in `platform/ios/swift-app`.
+
+<p align="center">
+  <img width="300" alt="Swift app screenshot" src="https://github.com/user-attachments/assets/87f4cea4-40dd-4744-a935-c7cebd6887f1" />
+</p>
+
+You can also build and run it from the command line with:
+
+```
+bazel run --//:renderer=metal //platform/ios/app-swift:MapLibreApp
+```