<!-- mobian-agent-page publisher="dailydev" canonical="https://daily.dev/posts/think-before-you-arrange-iyedbvrz6" -->

---
title: Think Before You Arrange | daily.dev
description: An architectural critique of SwiftUI's new ArrangementView API, introduced for the iPhone Duo's foldable form factor. The piece dissects why the API feels...
canonical: https://daily.dev/posts/think-before-you-arrange-iyedbvrz6
twitter:card: summary_large_image
twitter:site: @dailydotdev
og:type: website
og:site_name: daily.dev
og:title: Think Before You Arrange | daily.dev
og:description: An architectural critique of SwiftUI's new ArrangementView API, introduced for the iPhone Duo's foldable form factor. The piece dissects why the API feels...
og:url: https://daily.dev/posts/think-before-you-arrange-iyedbvrz6
og:image: https://api.daily.dev/og/posts/iYeDbvRz6.png
og:image:alt: Think Before You Arrange
og:image:width: 1200
og:image:height: 630
og:locale: en
---

> ## Documentation Index
> Fetch the complete documentation index at: https://daily.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Think Before You Arrange

**[Fatbobman](https://daily.dev/sources/fatbobman)** · [@fatbobman](https://daily.dev/fatbobman) · 10 min read · 0 upvotes · 0 comments

## Summary

An architectural critique of SwiftUI's new ArrangementView API, introduced for the iPhone Duo's foldable form factor. The piece dissects why the API feels awkward: primary/secondary semantics differ confusingly between split and overlay modes, split and overlay are actually two separate layout logics glued into one container with no continuous transition between them, and there's no centralized state telling child views what the container ultimately decided. The author argues ArrangementView shines specifically for fold-aware split/overlay relationships on the iPhone Duo but becomes a liability if treated as a general-purpose two-view container, and offers a checklist of questions to ask before adopting it over plain stacks or custom layouts.

## Full article

daily.dev links to this article rather than hosting it. Read it at the original source: <https://fatbobman.com/en/posts/arrangementview-think-before-you-arrange>

## Questions this post answers

### What does primary mean differently in ArrangementView's split versus overlay arrangement?

In a split arrangement, the primary view is the one that stays visible when space cannot accommodate both views. In an overlay arrangement, primary instead refers to the view on the upper layer, meaning primary/secondary roles can be swapped when switching between split and overlay, as shown in Apple's own PlayerView/UpNextView example.

_Developers weighing SwiftUI layout containers for foldables can find breakdowns like this on daily.dev._

### Can you get a smooth animated transition between split and overlay arrangements in SwiftUI's ArrangementView?

No, as tested in Xcode 27.1 beta there is no continuous transition between split and overlay states. Since .split and .overlay are different concrete types, switching requires an if-else that changes view identity, and even UIKit's updateArrangement(_:animated:) still produces a hard switch rather than a smooth transformation.

_Track evolving SwiftUI layout API behavior like this on daily.dev before committing to a design._

### How do I know which arrangement (split or overlay) ArrangementView is actually showing at a given moment?

There is no single centralized value that reports the container's final resolved state. Properties like overlayArrangementZIndex, splitArrangementAxis, and reservedRegions expose only pieces of the layout process, so an overlayArrangementZIndex of 0 alone can't tell you if the overlay has become side by side; apps must infer the full state from scattered signals themselves.

_See practical teardown of API gaps like this on daily.dev when evaluating new SwiftUI containers._

## Similar posts on daily.dev

- [Size classes inside ArrangementView](https://daily.dev/posts/size-classes-inside-arrangementview-3jgtrnuzc) · Sarunw · 0 upvotes · 0 comments
- [Crease-Proof Layouts, Brain Rot Without the Black Frames, and Un-Breaking a Non-Breaking Release](https://daily.dev/posts/crease-proof-layouts-brain-rot-without-the-black-frames-and-un-breaking-a-non-breaking-release-mnygz7755) · Medium · 1 upvotes · 0 comments

---

Tags: [#architecture](https://daily.dev/tags/architecture), [#ios](https://daily.dev/tags/ios), [#swiftui](https://daily.dev/tags/swiftui)

[View this post on daily.dev](https://daily.dev/posts/think-before-you-arrange-iyedbvrz6)

```json
{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://daily.dev/#organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180},"sameAs":["https://twitter.com/dailydotdev","https://github.com/dailydotdev","https://www.linkedin.com/company/daily-dev-ltd"]},{"@type":"WebSite","@id":"https://daily.dev/#website","url":"https://daily.dev","name":"daily.dev","publisher":{"@id":"https://daily.dev/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://daily.dev/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]}
{"@context":"https://schema.org","@type":"TechArticle","headline":"Think Before You Arrange","url":"https://daily.dev/posts/think-before-you-arrange-iyedbvrz6","mainEntityOfPage":{"@type":"WebPage","@id":"https://daily.dev/posts/think-before-you-arrange-iyedbvrz6"},"datePublished":"2026-09-23T05:00:05.399Z","dateModified":"2026-09-24T20:00:12.138Z","description":"An architectural critique of SwiftUI's new ArrangementView API, introduced for the iPhone Duo's foldable form factor. The piece dissects why the API feels...","image":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/b408dfcf8edeaa0bc0bed3d3345eebc8?_a=AQAEuop","thumbnailUrl":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/b408dfcf8edeaa0bc0bed3d3345eebc8?_a=AQAEuop","isAccessibleForFree":true,"articleSection":"Fatbobman","inLanguage":"en","publisher":{"@type":"Organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180}},"author":{"@type":"Person","name":"Yang Xu","url":"https://daily.dev/fatbobman","image":"https://lh3.googleusercontent.com/a/AGNmyxYJD8FDo35yPZMvl1IE9sT7UrM002H-UQb82wk-6A=s96-c","interactionStatistic":{"@type":"InteractionCounter","interactionType":{"@type":"EndorseAction"},"userInteractionCount":60}},"commentCount":0,"discussionUrl":"https://daily.dev/posts/think-before-you-arrange-iyedbvrz6","interactionStatistic":[{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":0},{"@type":"InteractionCounter","interactionType":{"@type":"CommentAction"},"userInteractionCount":0}],"keywords":"architecture,ios,swiftui","timeRequired":"PT10M"}
{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://daily.dev"},{"@type":"ListItem","position":2,"name":"Fatbobman","item":"https://daily.dev/sources/fatbobman"},{"@type":"ListItem","position":3,"name":"Think Before You Arrange"}]}
{"@context":"https://schema.org","@type":"FAQPage","@id":"https://daily.dev/posts/think-before-you-arrange-iyedbvrz6#faq","mainEntity":[{"@type":"Question","name":"What does primary mean differently in ArrangementView's split versus overlay arrangement?","acceptedAnswer":{"@type":"Answer","text":"In a split arrangement, the primary view is the one that stays visible when space cannot accommodate both views. In an overlay arrangement, primary instead refers to the view on the upper layer, meaning primary/secondary roles can be swapped when switching between split and overlay, as shown in Apple's own PlayerView/UpNextView example. Developers weighing SwiftUI layout containers for foldables can find breakdowns like this on daily.dev."}},{"@type":"Question","name":"Can you get a smooth animated transition between split and overlay arrangements in SwiftUI's ArrangementView?","acceptedAnswer":{"@type":"Answer","text":"No, as tested in Xcode 27.1 beta there is no continuous transition between split and overlay states. Since .split and .overlay are different concrete types, switching requires an if-else that changes view identity, and even UIKit's updateArrangement(_:animated:) still produces a hard switch rather than a smooth transformation. Track evolving SwiftUI layout API behavior like this on daily.dev before committing to a design."}},{"@type":"Question","name":"How do I know which arrangement (split or overlay) ArrangementView is actually showing at a given moment?","acceptedAnswer":{"@type":"Answer","text":"There is no single centralized value that reports the container's final resolved state. Properties like overlayArrangementZIndex, splitArrangementAxis, and reservedRegions expose only pieces of the layout process, so an overlayArrangementZIndex of 0 alone can't tell you if the overlay has become side by side; apps must infer the full state from scattered signals themselves. See practical teardown of API gaps like this on daily.dev when evaluating new SwiftUI containers."}}]}
```

