iOS prototype agent decisions¶
- Kind: decision
- Date: 2026-10-09
- Source: moved from
how-it-works/plat/ios/prototype-agent.md; #10563, #11015, #11042, #11054, #11382, #15244, #15493, #15128, #15130 - Shaped: iOS simulator prototype agent
Context¶
The iOS agent renders the shared prototype spec in a SwiftUI window injected into the app’s process. Several behaviors had no direct Android equivalent and were recorded as open decisions.
Options¶
Not recorded.
Decision¶
- 2026-10-09 (#11015). All open decisions were settled:
inspectmaps toget_prototype_status; a bottom sheet lifts above the keyboard from keyboard-frame notifications;window.layer: "app"is ignored silently so one spec runs on both platforms. - Keyboard lift (#11042). The lift is the only thing that moves for the keyboard. On an iOS 26.5
simulator
ignoresSafeArea(.keyboard)alone still moved a 300 pt sheet 527 pt for a 334 pt lift, so both hosting controllers also setsafeAreaRegionsto none. - Scrims, 2026-10-10 (#11382).
window.placement.scrimand bottomSheetscrimresolve throughPrototypePalette.scrim. - Effects on platform views (#15130). SwiftUI draws a placeholder for a platform-backed view inside
a
layerEffectordistortionEffect. The shader-sampled effects are omitted on a node that is or holds such a view, not on the whole spec, and reported indegradedEffects. - 2026-10-26 (#15244, full list in
prototype-ux.md).theme.designdefaults toplatform(native SwiftUI controls where covered; segmentedPicker,TabViewandMenukeep the custom drawing because they lose per-item identifiers). Anandroid: {...}namespace block is ignored with aplatformNotesentry. System Reduce Motion andprefersCrossFadeTransitionsmap to the reduced motion profile (crossfades), superseding earlier “instant” wording. iOS reports only the horizontal size class.
Consequences¶
One spec runs on both platforms with differences reported in platformNotes.