# iPhone Duo app letterboxed or not full screen: why it happens and how to fix it

Source: https://foldready.dev/guides/iphone-duo-app-letterboxed-fix

Published: 2026-09-12. Updated: 2026-09-12. Author: FoldReady (vity5.diduk@gmail.com).

Summary: An iOS app is letterboxed on iPhone Duo because it was built with an SDK older than iOS 27; rebuilding with Xcode 27.1 and the iOS 27.1 SDK removes the bars, and adopting size classes, flexible layouts and the ReservedRegion API makes the app fill the inner display correctly.

You opened your app on an iPhone Duo and it sits in the middle of the inner display with dark bars around it, or it fills the screen but every control is stretched. Both are expected behavior for apps that predate the Duo SDK, and both are fixable in days, not months.

## Why is my app letterboxed on iPhone Duo?

iOS decides how much of the inner display an app may use from the SDK the app was built against. Apps built with an SDK older than iOS 27 run in a compatibility window with limited screen usage, which appears as letterboxing. Apps built with the iOS 27 SDK extend past the status bar on the inner display. Apps built with the iOS 27.1 SDK reach the screen edge and get vertically laid out navigation and toolbar buttons. The letterbox is a promise from Apple that old apps still work; it is not a bug in your code.

## Why is my app stretched instead of letterboxed?

If the app was already built with a recent SDK, it fills the display, but layouts written for a compact-width iPhone are now given regular width. A single column stretches across the 4.4-inch-wide inner display, buttons sized from the screen width become enormous, and lists show one item per row with empty space on both sides. Stretching is a size-class problem, not an SDK problem.

## How do I fix it?

1. Rebuild with Xcode 27.1 and the iOS 27.1 SDK. This alone removes the letterbox and lets the app reach the screen edge.
2. Delete UIRequiresFullScreen from Info.plist if present. Apple deprecated the key in 2025 and the system ignores it once the app links against the iPadOS 26 SDK or later, so there is no longer a way to opt out of resizing or side-by-side multitasking. Leaving it in only misleads the next engineer.
3. Replace device idiom and orientation checks with size classes. The inner display is regular width and regular height; the outer display is compact width.
4. Give regular width a real layout: NavigationSplitView or UISplitViewController, adaptive grids, and a maximum content width for reading views.
5. Remove UIScreen.main.bounds and fixed frame sizes. Size from the container so the window can change live when the device opens or closes.
6. Adopt the ReservedRegion API for custom bars and edge-to-edge canvases so they do not collide with system UI, the fold or the camera.
7. Run every screen through all six poses in the Device Hub simulator and fix what you see.

## How long does the fix take?

| Situation | Typical effort | What you get |
| --- | --- | --- |
| Letterboxed, otherwise fine | Half a day | Rebuild with Xcode 27.1, retest, resubmit |
| Stretched single-column app, 10 to 20 screens | 3 to 6 engineering days | Size-class layouts, split view on the inner display |
| Custom navigation bars, media or camera screens | 1 to 3 weeks | ReservedRegion adoption, half-fold layouts, state preservation |
| Cross-platform app (React Native, Flutter) | 1 to 2 weeks | Window-dimension fixes plus native layout work at the edges |

Effort estimates assume a team that already ships iOS regularly. After previous form-factor launches, reviewers noticed compatibility-mode apps within days, so it is reasonable to prioritize the rebuild first and the layout work in a follow-up release.

> Not sure which case you are in? Send the App Store link and FoldReady will tell you within 24 hours whether a rebuild is enough or a readiness audit is worth it.

## FAQ

**Does letterboxing hurt my App Store rating?**

Indirectly. Early buyers of a new form factor tend to be enthusiasts who leave reviews, and after previous launches, apps that ran in compatibility mode drew one-star reviews in the first weeks. Expect the same pattern on a $1,999 device.

**Will Apple reject my app if it is letterboxed on iPhone Duo?**

No. Apple runs older apps in a compatibility mode on purpose. Letterboxing is a user experience problem, not a review guideline violation.

**Can I fix letterboxing without changing any code?**

Often yes for the letterbox itself: rebuilding with Xcode 27.1 removes it. Stretched layouts need code changes.

## Sources

- [Apple Tech Talk: Prepare your app for iPhone Duo](https://developer.apple.com/videos/play/tech-talks/111461/)
- [Apple Tech Talk: Strike a pose with adaptive layouts on iPhone Duo](https://developer.apple.com/videos/play/tech-talks/111463/)