Home / Apps / Adapting an app for iPhone Duo
Apps
Adapting an app for iPhone Duo
Every existing iPhone app runs on iPhone Duo, but only apps built with the iOS 27.1 SDK or later extend to use the full display. Here is what Apple's documentation, Human Interface Guidelines and Tech Talks tell developers to change.

Key facts
Build with the iOS 27.1 SDK in Xcode 27.1 so your app extends to use the full display, then fix screen-size, orientation and device-idiom assumptions, as Apple's prep page advises. Apple's own developer news post ties the iPhone Duo badge to submitting iPhone Duo screenshots, which become mandatory for all submissions starting April 2027.
Every existing iPhone app runs on iPhone Duo, but only apps built with a recent SDK use the whole inner display. Apple's three-step prep page for developers says apps built with the iOS 27 SDK and later resize dynamically, moving to the inner display when the phone opens and back to the outer display when it closes. The same page warns that hardcoded screen sizes, fixed orientations and device assumptions can leave content stretched, clipped or misplaced.
This guide is built from Apple's documentation and Tech Talks, not from shipping an app: the SDK tiers, the badge, the layout APIs and testing.
Which SDK you build with decides how your app looks
| Built with | Inner display behavior (per Apple) |
|---|---|
| iOS 26 SDK or earlier | Runs but won't adapt to all layouts; centered with empty space around it when open |
| iOS 27 SDK | Fills most of the inner display, but stays clear of the status bar on the right edge |
| iOS 27.1 SDK or later | Extends to use the full display, with toolbars and tab bars moved to a vertical column below the status bar |
Source: Apple Developer, Three steps to make your app shine on iPhone Duo.
Before you ship an iOS 27.1 SDK build, the prep page tells you to confirm your content adapts to vertical bars.
App Store badge and labels
Apple's own developer news post from Oct 5 says that if you submit iPhone Duo screenshots in App Store Connect, your App Store product page will display a badge.
Separately, a MacRumors report on the App Store label says Apple will label apps "Made for iPhone Duo," and that an app must be built with the iOS 27.1 SDK or later to be optimized for iPhone Duo.
The same Apple post says all submitted apps and games must include iPhone Duo screenshots starting April 2027. It also describes a new preview tool in App Store Connect for checking how screenshots and product page headers look on iPhone Duo. Apple's prep page suggests nominating your app for featuring and noting in Helpful Details that it is optimized for iPhone Duo, including all device poses.
MacRumors reported on Nov 6 that Apple counts more than 100,000 apps built for iPhone Duo, while well-known apps are still waiting on updates.
Lay out by available space, not by device
The Human Interface Guidelines page Designing for iPhone Duo says a compact width layout for the outer display and a regular width layout for the inner display "give you the fundamentals for every pose." In Apple's Prepare your app for iPhone Duo Tech Talk, the inner display is described as regular in both dimensions, and it doesn't honor supported interface orientations.
Apple's prep page tells you to replace UIScreen.main.bounds with view or window bounds, use GeometryReader or onGeometryChange in SwiftUI, and create windows with UIWindow(windowScene:). It also says not to treat horizontalSizeClass == .regular as iPad, because iPhones can now have any size class combination.
Apple's Preparing your app for iPhone Duo documentation recommends system containers such as split views, tab bars, arrangement views and navigation stacks, which it says handle resizing and camera occlusions on their own. If your app already works on iPad and Mac or resizes in iPhone Mirroring, Apple says you're well on your way.
Bars move to the side
On the outer display and in some inner display layouts, iPhone Duo puts navigation bars, toolbars and tab bars in a vertical column on the side, according to Apple's documentation. The HIG says the exception is the inner display in portrait, which keeps standard horizontal bars. If your bars don't move, Apple says to check that you use the bars that containers provide, such as toolbar(content:) on a NavigationStack or NavigationSplitView, rather than a custom UIToolbar, UINavigationBar or UITabBar.
Apple's documentation lists axisBehavior to control whether an item appears in vertical layouts, visibilityPriority to set overflow order, ToolbarOverflowMenu (SwiftUI) or additionalOverflowItems (UIKit) for the overflow menu, and topBarPinnedTrailing or pinnedTrailingGroup for a prominent Done button. To opt a sheet out of vertical bars on the outer display, it names toolbarVerticalBehavior(_:) and preferredVerticalBarBehavior.
One catch: per Apple's documentation, an item with a title but no icon, or a custom view, won't be placed vertically. Give toolbar items both an icon and a title so the system can place them anywhere.
Handling the fold
Apple calls the fold and the cameras reserved regions. The documentation describes the inner front camera as able to block your view only when active, while the outer front camera always occludes it. For custom views, it points to reservedRegions(kind:options:layoutDirectionBehavior:) on GeometryProxy in SwiftUI and reservedRegions(kind:options:) on UIView in UIKit, and notes that the fold region is active when the phone is partially open and inactive when fully open.
For two-pane layouts, Apple added an arrangement view: ArrangementView in SwiftUI and UIArrangementViewController in UIKit. The documentation describes a split style that places views side by side or stacked around the fold, and an overlay style that splits them across the fold only when the phone is partially open. The HIG adds a tip: prefer an even number of grid columns so content divides cleanly.
More on the poses owners use: tent and laptop modes.
Hinge angle, Split View and the outer display
Apple's Leverage multiple displays and scenes on iPhone Duo Tech Talk introduces onHingeChange in SwiftUI and UIHingeInteraction in UIKit, which report hinge status and angle. The talk advises using hinge data for interactions and effects, and the arrangement and region APIs for layout.
The same talk says all apps take part in side-by-side multitasking, and that new windows can't be created on the outer display. It recommends UIWindowSceneActivationAction, which hides itself when new windows aren't available. More on the owner side: how Split View works.
Camera apps get their own outer display option. The talk describes CameraCaptureAccessory, registered through the sceneAccessory modifier, which shows extra UI on the outer display while your main UI stays on the inner display. It's available when your app is full screen on the inner display with an active camera session.
Testing without an iPhone Duo
Apple's prep page lists three options: the iOS resizable simulator in Device Hub, iPhone Mirroring on macOS 27 resized to extremes, and the iPhone Duo simulator in Xcode 27.1, which it calls the best way to test the full experience.
Apple also offers an automated pass. The prep page says you can ask Xcode's coding assistant to "get my app ready for iPhone Duo," and that the skill finds most issues but not all. Apple's Get ready for iPhone Duo hub links the Tech Talks, in-person workshops and forums, and MacRumors covered the video series when Apple posted it on Sep 9.
Bottom line
Based on Apple's documentation, it looks like rebuilding with Xcode 27.1 gets you most of the way if your app uses standard containers and sizes itself from its own bounds. Custom bars, screen-size math and orientation checks are likely where the real work is, since Apple says framework views already adjust around the fold. For apps that have already made the jump, see the best apps for iPhone Duo.
Building for iPhone Duo? Tell us which API surprised you most.
Frequently asked questions
Do old iPhone apps work on iPhone Duo?
Which Xcode version do I need for iPhone Duo?
How does my app get the Made for iPhone Duo badge?
Can I test without buying an iPhone Duo?
Is there an API for the hinge angle?
Found this useful? Share it.
Sources (11)
From Apple
- Apple DeveloperThree steps to make your app shine on iPhone Duo
- Apple Developer DocumentationPreparing your app for iPhone Duo
- Apple DeveloperDesigning for iPhone Duo (Human Interface Guidelines)
- Apple Developer NewsPrepare and submit your apps for iPhone Duo
- Apple DeveloperPrepare your app for iPhone Duo (Tech Talk)
- Apple DeveloperLeverage multiple displays and scenes on iPhone Duo (Tech Talk)
- Apple DeveloperGet ready for iPhone Duo
Coverage
Last verified