Skip to content

docs: Adding note regarding iPadOS 26 windowing #517

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
theproducer merged 3 commits into from
Mar 13, 2026
Merged

docs: Adding note regarding iPadOS 26 windowing #517

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
56d976a
docs: Adding note regarding iPadOS 26 windowing
theproducer Feb 5, 2026
75cc12c
Adding note that this workaround is temporary
theproducer Mar 12, 2026
cc12251
Merge branch 'main' into ios26-windowing
theproducer Mar 12, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions docs/main/ios/configuration.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -62,3 +62,20 @@ Finally, add the `scheme` attribute inside the `ios` object in the [Capacitor co
## Deeplinks (aka Universal Links)

For a Deep Links guide, [see here](/main/guides/deep-links.md).


## iPadOS 26
Starting in iPadOS 26, Apple has added new window controls to make the experience more desktop-like. These controls may overlap your app interface:
![UIDesignRequiresCompatibility plist entry](../../../static/img/ipados-controls-overlap.png)

To fix this add the following entry to your `Info.plist`:
`UIDesignRequiresCompatibility = YES`:
Comment on lines +71 to +72
Copy link
Copy Markdown
Contributor

@OS-pedrogustavobilro OS-pedrogustavobilro Feb 5, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What other changes does UIDesignRequiresCompatibility YES create on Capacitor app UI?

Docs aren't exactly clear on that https://developer.apple.com/documentation/BundleResources/Information-Property-List/UIDesignRequiresCompatibility - It makes the app look like it was run on iOS 18? Disables Liquid Glass (which I guess Ionic doesn't support yet), and...?

Also there's this

Warning
Temporarily use this key while reviewing and refining your app’s UI for the design in the latest SDKs.

Which makes this seem like it won't be a solution forever, probably won't work on 27?

Copy link
Copy Markdown
Contributor Author

@theproducer theproducer Feb 5, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, the problem is that Capacitor itself isn't SwiftUI yet, so we can't support some of the more intricate controls available for iOS 26. Changing that should be one of our goals for Capacitor 9 to get ahead of iOS 27.

The docs aren't clear, but since this was introduced in iOS26, I'm going to strongly assume the "compatibility" mode means disabling some assumptions in Liquid Glass that might be a problem if you haven't fully adopted it in your designs yet. The blast radius of that setting shouldn't be that wide.

Copy link
Copy Markdown
Contributor

@OS-pedrogustavobilro OS-pedrogustavobilro Feb 5, 2026 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Makes sense, not much to do for right now then, but hopefully soon heh

Copy link
Copy Markdown
Member

@markemer markemer Feb 6, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, maybe we want to remove the storyboard and use very minimal SwiftUI in Cap 9 or 10?

Copy link
Copy Markdown
Member

@markemer markemer Feb 6, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we should call this a temporary workaround here?

Copy link
Copy Markdown
Contributor

@OS-pedrogustavobilro OS-pedrogustavobilro Feb 25, 2026 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@theproducer pinging this to bring back this thread, to see if the PR needs any additional changes.

Copy link
Copy Markdown
Contributor Author

@theproducer theproducer Mar 12, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, I updated the note to indicate that this is temporary.


![UIDesignRequiresCompatibility plist entry](../../../static/img/ipados-controls-plist.png)

This should prevent the controls from overlapping:
![UIDesignRequiresCompatibility plist entry](../../../static/img/ipados-controls-fixed.png)


This is a temporary fix until we add further configuration over the windowing controls in future versions of Capacitor.

Binary file added static/img/ipados-controls-fixed.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/ipados-controls-overlap.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/ipados-controls-plist.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.