Big update: Face unlock comes to iPhone Duo in the iOS 27.3 developer betaFace unlock in 27.3 betaWhat's new and how it works →Read more →

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.

Clay illustration of an open foldable showing layout tiles beside a wrench

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 withInner display behavior (per Apple)
iOS 26 SDK or earlierRuns but won't adapt to all layouts; centered with empty space around it when open
iOS 27 SDKFills most of the inner display, but stays clear of the status bar on the right edge
iOS 27.1 SDK or laterExtends 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?
Yes. Apple says apps built with the iOS 26 SDK or earlier still run, but they won't adapt to all layouts and sit centered with empty space around them on the inner display.
Which Xcode version do I need for iPhone Duo?
Apple's developer news post says to recompile with Xcode 27.1, which adds iPhone Duo development support, and its prep page says apps built with the iOS 27.1 SDK or later extend to use the full display.
How does my app get the Made for iPhone Duo badge?
Apple's developer news post and prep page say submitting iPhone Duo screenshots in App Store Connect shows a badge on your product page. MacRumors reports Apple said apps will be labeled "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.
Can I test without buying an iPhone Duo?
Yes. Apple lists the iOS resizable simulator in Device Hub, iPhone Mirroring on macOS 27, and the iPhone Duo simulator in Xcode 27.1, which it calls the best way to test the full experience.
Is there an API for the hinge angle?
Yes. Apple's Tech Talk on multiple displays and scenes introduces onHingeChange in SwiftUI and UIHingeInteraction in UIKit, which report hinge status and angle, and advises using layout APIs rather than hinge data for layout.

Found this useful? Share it.

Sources (11)Apple Developer, Apple Developer Documentation, Apple Developer News, MacRumors · checked Nov 12, 2026

Last verified

Discuss this guide in the forum →