Skip to content

fix(ios): preserve Liquid Glass on iOS 26 by skipping custom UITabBarAppearance#509

Open
deepak0x wants to merge 1 commit intocallstack:mainfrom
deepak0x:fix/ios26-liquid-glass-appearance
Open

fix(ios): preserve Liquid Glass on iOS 26 by skipping custom UITabBarAppearance#509
deepak0x wants to merge 1 commit intocallstack:mainfrom
deepak0x:fix/ios26-liquid-glass-appearance

Conversation

@deepak0x
Copy link
Copy Markdown

@deepak0x deepak0x commented Mar 30, 2026

Problem

On iOS 26, the system provides a Liquid Glass material for UITabBar automatically. However, updateTabBarAppearance() in TabViewImpl.swift calls configureStandardAppearance(), which creates a custom UITabBarAppearance with explicit background and item styling. Apple's WWDC25 session 284 ("Build a UIKit app with the new design") says:

"Remove any background customization from your navigation and toolbars. Using UIBarAppearance or backgroundColor interferes with the glass appearance."

So any app using react-native-bottom-tabs on iOS 26 gets an opaque tab bar instead of Liquid Glass, even with UIDesignRequiresCompatibility = false in Info.plist.

Fix

Add an early return in updateTabBarAppearance() on iOS 26+ when:

  • No explicit barTintColor is set (the app wants the system default)
  • scrollEdgeAppearance is not "opaque" (the app is not requesting an opaque bar)

In this case, we skip configureStandardAppearance() and let iOS render Liquid Glass. The inactive tint color is still applied via tabBar.unselectedItemTintColor for apps that set tabBarInactiveTintColor.

If the app sets a custom barTintColor or requests an opaque appearance, the existing code path runs as before. On iOS 25 and below, the early return is guarded by #available(iOS 26.0, *) so the existing code path is completely unchanged.

Testing

Tested with the Rocket.Chat React Native app connected to a live server. Liquid Glass renders on the tab bar after the fix. Without it, the tab bar is opaque.

Related to #439

…Appearance

On iOS 26, creating a custom UITabBarAppearance replaces the
system-provided Liquid Glass material. This adds an early return in
updateTabBarAppearance() on iOS 26+ when no explicit barTintColor or
opaque scrollEdgeAppearance is set, so the system renders Liquid Glass
instead.

The inactive tint color is still applied via tabBar.unselectedItemTintColor
for apps that set tabBarInactiveTintColor.

Fixes callstack#439
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant