Gate iOS glass layout on native support

[juliusmarminge]

Summary

• Add a shared native liquid-glass capability check for iOS-only glass behavior.
• Fall back to solid headers and non-overlapping scroll inset behavior when native glass is unavailable.
• Adjust affected mobile home, files, thread, and sidebar screens to avoid pre-glass iOS header/content overlaps.

Testing

• Added unit coverage for supportsNativeLiquidGlass platform and capability gating.
• Not run: validation commands not provided in prompt.

---

Note

Low Risk
UI/layout-only gating on an existing native capability check; no auth, data, or API changes. Main risk is visual/regression on pre-glass iOS devices, which this PR is intended to fix.

Overview
iOS liquid-glass UI is now gated on a shared runtime flag (NATIVE_LIQUID_GLASS_SUPPORTED) instead of treating every iOS device as glass-capable.

The flag combines Platform.OS === "ios" with @callstack/liquid-glass’s isLiquidGlassSupported, via a small supportsNativeLiquidGlass helper and unit tests.

When glass is off (older iOS or non-iOS), navigation and lists use solid sheet-colored headers, non-transparent bars, and no automatic scroll/content inset adjustment—so lists and empty states sit below the header instead of underlapping it. Glass-specific options (transparent headers, scroll-edge effects, editor nav item style, automatic contentInsetAdjustmentBehavior) apply only when the flag is true.

Touched surfaces include root GLASS_HEADER_OPTIONS, iPad sidebar stack chrome, Home, file tree, thread route/detail (including working-duration pill styling on legacy iOS), and thread navigation sidebar lists.

^{Reviewed by Cursor Bugbot for commit 5ddde32. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Gate iOS glass layout behavior on native liquid glass capability

• Introduces a NATIVE_LIQUID_GLASS_SUPPORTED runtime flag in native-glass.ts, derived from a new supportsNativeLiquidGlass helper that checks both Platform.OS === 'ios' and a native capability flag.
• Replaces all Platform.OS === 'ios' checks for glass-related UI (transparent headers, scroll edge effects, content inset adjustments) with NATIVE_LIQUID_GLASS_SUPPORTED across screens and navigation components.
• On iOS versions without native liquid glass support, headers render with a solid background, content insets are not auto-adjusted, and translucent pill/sidebar styles fall back to solid card styling.
• Behavioral Change: Pre-liquid-glass iOS devices now receive the same non-glass layout as non-iOS platforms for all affected screens.

📊 Macroscope summarized 5ddde32. 9 files reviewed, 0 issues evaluated, 0 issues filtered, 0 comments posted

🗂️ Filtered Issues

No issues evaluated.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 0271e970-1b36-48f5-ade1-5ccb694d8d1b

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch t3code/fix-ios18-non-glass-overlaps

---

_{Comment @coderabbitai help to get the list of available commands.}

[macroscopeapp]

🟠 High files/FileTreeBrowser.tsx:246

On iOS devices that don't support liquid glass, contentInsetAdjustmentBehavior is now set to "never", so the FlatList receives no automatic top inset and the first file rows render beneath the native header. This regresses from the previous Platform.OS === "ios" ? "automatic" : "never" behavior, which applied the inset on all iOS versions. The gating now uses NATIVE_LIQUID_GLASS_SUPPORTED instead of Platform.OS === "ios", so pre-glass iOS loses the inset even though the header is still translucent. Consider gating on Platform.OS === "ios" (or header translucency) rather than liquid-glass capability.

🚀 Reply "fix it for me" or copy this AI Prompt for your agent:

In file @apps/mobile/src/features/files/FileTreeBrowser.tsx around line 246:

On iOS devices that don't support liquid glass, `contentInsetAdjustmentBehavior` is now set to `"never"`, so the FlatList receives no automatic top inset and the first file rows render beneath the native header. This regresses from the previous `Platform.OS === "ios" ? "automatic" : "never"` behavior, which applied the inset on all iOS versions. The gating now uses `NATIVE_LIQUID_GLASS_SUPPORTED` instead of `Platform.OS === "ios"`, so pre-glass iOS loses the inset even though the header is still translucent. Consider gating on `Platform.OS === "ios"` (or header translucency) rather than liquid-glass capability.

[macroscopeapp]

Approvability

Verdict: Needs human review

1 blocking correctness issue found. An unresolved high-severity comment identifies a potential regression on older iOS devices where content may render beneath the header due to changed inset behavior. This bug concern warrants human review before merging.

No code changes detected at 5ddde32. Prior analysis still applies.

^{You can customize Macroscope's approvability policy. Learn more.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

^{Bugbot Autofix is ON, but it could not run because the branch was deleted or merged before autofix could start.}

^{Reviewed by Cursor Bugbot for commit 5ddde32. Configure here.}

[cursor]

Duplicate thread header controls

High Severity

On pre-glass iOS, changing usesNativeHeaderGlass to NATIVE_LIQUID_GLASS_SUPPORTED incorrectly activates ThreadGitControls' native header toolbar. This conflicts with the screen's existing compactRightHeaderItems logic, causing header actions to duplicate, disappear, or thrash.

 

^{Reviewed by Cursor Bugbot for commit 5ddde32. Configure here.}

[cursor]

Sidebar solid header fallback gap

Medium Severity

When native liquid glass is unavailable, SIDEBAR_SCREEN_OPTIONS clears transparency but leaves headerStyle undefined. The main stack’s glass preset falls back to SHEET_BACKGROUND_COLOR, so the iPad sidebar nav bar can keep a default system material instead of the intended solid sheet chrome.

Additional Locations (1)

• apps/mobile/src/Stack.tsx#L90-L95

 

^{Reviewed by Cursor Bugbot for commit 5ddde32. Configure here.}