# DuoReady adaptive transition starter pack

Status: example source and recommendations, NOT executed or compiled on macOS by DuoReady.

1. Create a disposable SwiftUI iOS sample app in Xcode with a UI-test target. Set its root view to TransitionFixture(). The fixture requires iOS 16 or newer.
2. Add TransitionFixture.swift to the app target and AdaptiveTransitionTests.swift to its UI-test target. Build locally and resolve any differences in your Xcode/runtime's accessibility element representation.
3. Run testDraftSurvivesNavigation. It checks state in the fixture, not your app.
4. Run testDraftAfterHumanAssistedDisplayTransition interactively. During its 120-second wait, perform one transition using Device Hub and tap Confirm transition review. This is a human-assisted test, not automated pose control. Do not run this test unattended.
5. Adapt the flow, identifiers and assertions to your own app. Add automatic UI tests for the journeys you can reproduce. Configure supported languages and text sizes in Xcode's test-plan editor, then repeat on the actual destinations installed on your Mac.
6. Fill transition-matrix.csv with the exact source commit, Xcode build, runtime, destination, starting pose and transition. Mark blocked/unavailable cases skipped, with a reason; never convert skipped cases into passes.
7. Inspect screenshots for clipping, asymmetric safe areas, keyboard coverage and meaningful RTL behavior. isHittable and screenshots alone do not prove visual correctness, accessibility or a transition actually occurred.
8. Keep xcresult and screenshots private. The current DuoReady Mac runner can import a suite summary at the matching commit; it does not attest individual matrix rows or execute these examples for you.

For iPad/resizable Apple UI, use the same assertions with supported window changes. Camera optics, real display timing and hardware behavior require device evidence.

Sources:
https://developer.apple.com/videos/play/tech-talks/111461/
https://developer.apple.com/documentation/xcode/organizing-tests-to-improve-feedback
https://developer.apple.com/documentation/xctest/xcuiapplication