feat: update iOS templates to use UIScene lifecycle

- Add iOS build CI workflow to verify UIScene configuration
- Update documentation with iOS Requirements section
- Update CHANGELOG

Requires updated template bundles from BrickHub after
VeryGoodOpenSource/very_good_templates#416 is merged.

Closes #1436

Author: meylis1998

.github/workflows/ios_build.yaml

@@ -0,0 +1,57 @@
+name: iOS Build Verification
+
+on:
+  pull_request:
+    paths:
+      - "lib/src/commands/create/templates/**"
+  push:
+    branches: [main]
+    paths:
+      - "lib/src/commands/create/templates/**"
+
+jobs:
+  ios-build:
+    runs-on: macos-latest
+    strategy:
+      matrix:
+        template:
+          - very_good_core
+          - very_good_flame_game
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: subosito/flutter-action@v2
+        with:
+          flutter-version: "3.38.x"
+          channel: stable
+
+      - name: Install Dependencies
+        run: dart pub get
+
+      - name: Generate Test Project
+        run: |
+          if [ "${{ matrix.template }}" = "very_good_core" ]; then
+            dart run bin/very_good.dart create flutter_app test_app --template core -o /tmp
+          else
+            dart run bin/very_good.dart create flutter_app test_app --template ${{ matrix.template }} -o /tmp
+          fi
+
+      - name: Build iOS (no-codesign)
+        working-directory: /tmp/test_app
+        run: flutter build ios --no-codesign --debug
+
+      - name: Verify UIScene Configuration
+        run: |
+          echo "Checking for UIApplicationSceneManifest in Info.plist..."
+          grep -q "UIApplicationSceneManifest" /tmp/test_app/ios/Runner/Info.plist || (echo "FAILED: UIApplicationSceneManifest not found" && exit 1)
+
+          echo "Checking for SceneDelegate.swift..."
+          test -f /tmp/test_app/ios/Runner/SceneDelegate.swift || (echo "FAILED: SceneDelegate.swift not found" && exit 1)
+
+          echo "Checking for @main in AppDelegate.swift..."
+          grep -q "@main" /tmp/test_app/ios/Runner/AppDelegate.swift || (echo "FAILED: @main not found in AppDelegate.swift" && exit 1)
+
+          echo "Checking for FlutterImplicitEngineDelegate in AppDelegate.swift..."
+          grep -q "FlutterImplicitEngineDelegate" /tmp/test_app/ios/Runner/AppDelegate.swift || (echo "FAILED: FlutterImplicitEngineDelegate not found" && exit 1)
+
+          echo "All UIScene configuration checks passed!"

CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## Unreleased
+
+### Features
+
+* update iOS templates to use UIScene lifecycle for Flutter 3.38+ ([#1436](https://github.com/VeryGoodOpenSource/very_good_cli/issues/1436))
+
+### Continuous Integration
+
+* add iOS build verification workflow ([#1436](https://github.com/VeryGoodOpenSource/very_good_cli/issues/1436))
+
 ## [0.28.0](https://github.com/VeryGoodOpenSource/very_good_cli/compare/v0.27.0...v0.28.0) (2025-10-03)
 
 

site/docs/templates/core.md

@@ -262,6 +262,29 @@ When you create a new project, it has a default launcher icon. To customize this
 
 3. Verify the icon has been replaced by running your app using `flutter run`.
 
+## iOS Requirements 🍏
+
+Very Good Core uses Apple's UIScene lifecycle, which is required for all UIKit apps built with iOS 26+ SDK. This ensures your app is future-proof and follows Apple's current platform guidance.
+
+### Requirements
+
+- **Flutter**: 3.38.0 or later
+- **Xcode**: 15.0 or later
+
+### UIScene Architecture
+
+The generated iOS project includes:
+
+- **`SceneDelegate.swift`** - Extends `FlutterSceneDelegate` to handle scene lifecycle events
+- **`AppDelegate.swift`** - Implements `FlutterImplicitEngineDelegate` for plugin registration
+- **`Info.plist`** - Contains `UIApplicationSceneManifest` configuration
+
+This architecture follows [Flutter's official UIScene migration guide][flutter_uiscene_migration].
+
+:::note
+If you're migrating an existing project to the UIScene lifecycle, refer to [Flutter's breaking changes documentation][flutter_uiscene_migration].
+:::
+
 [android_application_element]: https://developer.android.com/guide/topics/manifest/application-element
 [android_configuration_qualifiers]: https://developer.android.com/guide/topics/resources/providing-resources#AlternativeResources
 [bloc_pub]: https://pub.dev/packages/bloc
@@ -279,5 +302,6 @@ When you create a new project, it has a default launcher icon. To customize this
 [material_design_product_icons]: https://material.io/design/iconography/
 [sentry_link]: https://sentry.io
 [very_good_coverage]: https://github.com/marketplace/actions/very-good-coverage
+[flutter_uiscene_migration]: https://docs.flutter.dev/release/breaking-changes/ios-flutterviewcontroller-scenedelegate
 [vga]: https://github.com/VeryGoodOpenSource/very_good_analysis
 [vgv]: https://verygood.ventures