Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Presentations

duo-system-surfaces

Widgets, Live Activities, StandBy and Controls for apps on iPhone Duo, Apple's foldable. Use it when you build or check a widget extension, a Live Activity, a Dynamic Island presentation, a StandBy layout or a Control Center or Lock Screen control, and the app runs on iPhone Duo. Covers the redesigned Dynamic Island in the side column of the outer and inner display, which grows down that column as Live Activities arrive and takes room from the app's own vertical bars (measured: about 84 pt closed, 94 pt open); isDynamicIslandLimitedInWidth (iOS 27, names iPhone Duo) for narrow compact and minimal views that fit a 28 pt circle; StandBy on either display, even when not charging; two Home Screen pages and Today View; widget families, including the new systemExtraLargePortrait, where Apple's pages disagree; controls with no Action button on Duo; deep links that work closed and open. Says what Apple has not published, what the simulator cannot run (StandBy, most app extensions) and what to

Kimeur · Static checks on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add Kimeur/duology --skill duo-system-surfaces

About this skill


name: duo-system-surfaces description: "Widgets, Live Activities, StandBy and Controls for apps on iPhone Duo, Apple's foldable. Use it when you build or check a widget extension, a Live Activity, a Dynamic Island presentation, a StandBy layout or a Control Center or Lock Screen control, and the app runs on iPhone Duo. Covers the redesigned Dynamic Island in the side column of the outer and inner display, which grows down that column as Live Activities arrive and takes room from the app's own vertical bars (measured: about 84 pt closed, 94 pt open); isDynamicIslandLimitedInWidth (iOS 27, names iPhone Duo) for narrow compact and minimal views that fit a 28 pt circle; StandBy on either display, even when not charging; two Home Screen pages and Today View; widget families, including the new systemExtraLargePortrait, where Apple's pages disagree; controls with no Action button on Duo; deep links that work closed and open. Says what Apple has not published, what the simulator cannot run (StandBy, most app extensions) and what to test on a device." metadata: verified: "Xcode 27.1 (27A9275), iOS 27.1 simulator, device: no" sources: "https://github.com/Kimeur/duology/blob/main/reference/sources.md"

duo-system-surfaces

The system draws your widgets, Live Activities and controls, not your app. On iPhone Duo it draws them in new places: a Dynamic Island in the side column of both displays, two Home Screen pages with Today View, StandBy on either display. You can't lay these places out. Your job is to give each presentation content that still reads when the system makes it narrower, taller or bigger, and to check on a device what the simulator can't show.

Load neighbours when the task needs them: duo-navigation (your app's bars, which share the side column with the island), duo-continuity (opening the right screen from a tap), duo-swiftui-27 (visibilityPriority and the other iOS 27 toolbar APIs).

Labels: measured means we ran it on the iPhone Duo simulator (iOS 27.1, 20 October 2026). Unverified means we could not confirm it. Not published means Apple has said nothing about it as of 20 October 2026. Everything else links to Apple. Runs: references/evidence.md. Sources: reference/sources.md.

What Apple has said about iPhone Duo

ClaimSource
The side column of both displays holds the status bar and the Dynamic Island. The island is redesigned to fit vertically there and expands to show Live Activities and alerts.Newsroom, Tech Talk 111466, HIG
On the outer display the island grows out of the front camera's region, which is always present.HIG
App bars share that column with Live Activities and the status bar. When room runs out, app items collapse into the overflow menu.Tech Talk 111466
The system draws compact and minimal Live Activity views narrower on iPhone Duo (and on iPhone held sideways). Read isDynamicIslandLimitedInWidth (iOS 27.0).doc
Where width is limited (which the doc above says includes iPhone Duo), compact and minimal views should fit a 28 pt circle. A leading view alone is fine; the system then hides the trailing one.HIG: Live Activities (updated 13 Oct 2026)
Open, the display shows two Home Screen pages, with Today View (a scrolling list of widgets) on the left. The Dock and Lock Screen controls sit on the side.Newsroom
Set down, iPhone Duo enters StandBy on the outer or the inner display, even when it isn't charging.Newsroom
iOS 27 adds the systemExtraLargePortrait widget family to iOS.doc, WWDC26 session 277
The spec page lists volume buttons, Camera Control and the side button, and no Action button.Specs

What Apple has not published

  • Widget sizes in points on either display. The HIG's iOS widget table has no iPhone Duo row (HIG: Widgets).
  • Which families each Home Screen offers. The HIG's family table says iPhone supports neither extra-large family; the API doc and session 277 say systemExtraLargePortrait comes to iOS 27. Whether Duo offers it is unverified.
  • How compact, minimal and expanded views are laid out in a vertical island, how several activities stack there, and their sizes. The HIG's Live Activity table lists two iPhone screen sizes only.
  • StandBy on Duo: sizes, which faces go on which display, how a widget or Live Activity looks there.
  • Anything about controls on Duo. The HIG's Controls page has not changed since June 2024.
  • An iOS 27 entry on the WidgetKit or ActivityKit updates pages. The two iOS 27 additions above (isDynamicIslandLimitedInWidth, systemExtraLargePortrait) appear only in the SDK and the symbol docs. The ActivityKit interface in the iOS 27.1 SDK has no iOS 27 symbols.

What the simulator can and can't show

Xcode 27.1's

Read the complete source ↗