react-native-navigation 8.8.2 → 8.8.3-snapshot.2506

package/android/src/test/java/com/reactnativenavigation/viewcontrollers/toptabs/TopTabsViewControllerTest.java

@@ -40,7 +40,6 @@ import static org.mockito.Mockito.spy;
 import static org.mockito.Mockito.times;
 import static org.mockito.Mockito.verify;
 
-@Ignore("New architecture - WIP")
 public class TopTabsViewControllerTest extends BaseTest {
     private static final int SIZE = 2;
 

package/android/src/test/java/com/reactnativenavigation/viewcontrollers/viewcontroller/ViewControllerTest.java

@@ -40,7 +40,6 @@ import static org.mockito.Mockito.times;
 import static org.mockito.Mockito.verify;
 import static org.mockito.Mockito.withSettings;
 
-@Ignore("New architecture - WIP")
 public class ViewControllerTest extends BaseTest {
 
     private ViewController uut;

package/android/src/test/java/com/reactnativenavigation/views/TitleAndButtonsContainerTest.kt

@@ -30,7 +30,6 @@ import kotlin.test.assertFalse
 private const val UUT_WIDTH = 1000
 private const val UUT_HEIGHT = 100
 
-@Ignore("New architecture - failed to fix")
 class TitleAndButtonsContainerTest : BaseTest() {
     lateinit var uut: TitleAndButtonsContainer
     private lateinit var activity: Activity

package/android/src/test/java/com/reactnativenavigation/views/TitleSubTitleLayoutTest.kt

@@ -12,7 +12,6 @@ import org.junit.Test
 private const val UUT_WIDTH = 1000
 private const val UUT_HEIGHT = 100
 
-@Ignore("New architecture - WIP")
 class TitleSubTitleLayoutTest : BaseTest() {
     private val testId = "mock-testId"
 

package/ios/BottomTabPresenter.h

@@ -2,6 +2,8 @@
 #import "RNNTabBarItemCreator.h"
 @interface BottomTabPresenter : RNNBasePresenter
 
+@property(nonatomic, strong, readonly) RNNTabBarItemCreator *tabCreator;
+
 - (instancetype)initWithDefaultOptions:(RNNNavigationOptions *)defaultOptions
                             tabCreator:(RNNTabBarItemCreator *)tabCreator;
 

package/ios/BottomTabPresenter.mm

@@ -3,9 +3,7 @@
 #import "UIViewController+LayoutProtocol.h"
 #import "UIViewController+RNNOptions.h"
 
-@implementation BottomTabPresenter {
-    RNNTabBarItemCreator *_tabCreator;
-}
+@implementation BottomTabPresenter
 
 - (instancetype)initWithDefaultOptions:(RNNNavigationOptions *)defaultOptions
                             tabCreator:(RNNTabBarItemCreator *)tabCreator {

package/ios/BottomTabsAfterInitialTabAttacher.mm

@@ -9,6 +9,10 @@
       for (UIViewController *viewController in bottomTabsController.deselectedViewControllers) {
         dispatch_async(dispatch_get_main_queue(), ^{
           UIWindow *preloadWindow = [[UIWindow alloc] initWithFrame:CGRectZero];
+          // Clip the preload window so the deselected tab's full-screen reactView,
+          // which is briefly hosted here while it renders, can't draw outside the
+          // zero-frame window and flicker over the already-visible selected tab.
+          preloadWindow.clipsToBounds = YES;
           preloadWindow.hidden = NO;
 
           dispatch_group_t ready = dispatch_group_create();

package/ios/BottomTabsTogetherAttacher.mm

@@ -7,6 +7,10 @@
     dispatch_group_t ready = dispatch_group_create();
     
     UIWindow *preloadWindow = [[UIWindow alloc] initWithFrame:CGRectZero];
+    // Clip the preload window so the full-screen reactViews hosted here while
+    // they render can't draw outside the zero-frame window. Today the splash
+    // screen masks this, but without clipping it's a latent flicker.
+    preloadWindow.clipsToBounds = YES;
     preloadWindow.hidden = NO;
     
     NSMapTable *reactViewToParent = [NSMapTable strongToStrongObjectsMapTable];

package/ios/RNNAppDelegate.mm

@@ -4,7 +4,6 @@
 #import <react/featureflags/ReactNativeFeatureFlagsDefaults.h>
 
 #import "RCTAppSetupUtils.h"
-#import <React/CoreModulesPlugins.h>
 #if __has_include(<React/RCTCxxBridgeDelegate.h>)
 #import <React/RCTCxxBridgeDelegate.h>
 #endif
@@ -56,12 +55,17 @@ static NSString *const kRNConcurrentRoot = @"concurrentRoot";
 - (BOOL)application:(UIApplication *)application
 didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
     
+// RN 0.77 & RN0.78
 #if !RNN_RN_VERSION_79_OR_NEWER
-    [self _setUpFeatureFlags];
+#if __has_include(<ReactAppDependencyProvider/RCTAppDependencyProvider.h>)
+    self.dependencyProvider = [RCTAppDependencyProvider new];
+#endif
+    // RN 0.77
     #if !RNN_RN_VERSION_78
+        [self _setUpFeatureFlags];
         self.rootViewFactory = [self createRCTRootViewFactory];
-    #else
-        self.reactNativeFactory = [[RCTReactNativeFactory alloc] init];
+    #else // RN0.78
+        self.reactNativeFactory = [[RCTReactNativeFactory alloc] initWithDelegate:self];
         self.reactNativeFactory.rootViewFactory = [self createRCTRootViewFactory];
     #endif
     
@@ -119,6 +123,13 @@ didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
     return [[RCTRootViewFactory alloc] initWithConfiguration:configuration andTurboModuleManagerDelegate:self];
 }
 
+#pragma mark - RCTTurboModuleManagerDelegate
+
+- (id<RCTTurboModule>)getModuleInstanceFromClass:(Class)moduleClass
+{
+    return RCTAppSetupDefaultModuleFromClass(moduleClass, self.dependencyProvider);
+}
+
 #pragma mark - Feature Flags
 class RCTAppDelegateBridgelessFeatureFlags : public facebook::react::ReactNativeFeatureFlagsDefaults {
 public:

package/ios/RNNBackButtonOptions.h

@@ -18,6 +18,7 @@
 @property(nonatomic, strong) Text *identifier;
 @property(nonatomic, strong) Bool *popStackOnPress;
 @property(nonatomic, strong) RNNIconBackgroundOptions *iconBackground;
+@property(nonatomic, strong) Bool *hideSharedBackground;
 
 - (BOOL)hasValue;
 

package/ios/RNNBackButtonOptions.mm

@@ -20,6 +20,7 @@
     self.displayMode = [TextParser parse:dict key:@"displayMode"];
     self.popStackOnPress = [BoolParser parse:dict key:@"popStackOnPress"];
     self.iconBackground = [[RNNIconBackgroundOptions alloc] initWithDict:dict[@"iconBackground"] enabled:nil];
+    self.hideSharedBackground = [BoolParser parse:dict key:@"hideSharedBackground"];
 
     return self;
 }
@@ -54,6 +55,8 @@
         self.popStackOnPress = options.popStackOnPress;
     if (options.sfSymbol.hasValue)
         self.sfSymbol = options.sfSymbol;
+    if (options.hideSharedBackground.hasValue)
+        self.hideSharedBackground = options.hideSharedBackground;
 }
 
 - (BOOL)hasValue {

package/ios/RNNBottomTabOptions.h

@@ -25,6 +25,7 @@
 @property(nonatomic, strong) Bool *selectTabOnPress;
 @property(nonatomic, strong) Text *sfSymbol;
 @property(nonatomic, strong) Text *sfSelectedSymbol;
+@property(nonatomic, strong) Text *role;
 
 - (BOOL)hasValue;
 

package/ios/RNNBottomTabOptions.mm

@@ -31,6 +31,7 @@
     self.selectTabOnPress = [BoolParser parse:dict key:@"selectTabOnPress"];
     self.sfSymbol = [TextParser parse:dict key:@"sfSymbol"];
     self.sfSelectedSymbol = [TextParser parse:dict key:@"sfSelectedSymbol"];
+    self.role = [TextParser parse:dict key:@"role"];
 
     return self;
 }
@@ -76,6 +77,8 @@
         self.sfSymbol = options.sfSymbol;
     if (options.sfSelectedSymbol.hasValue)
         self.sfSelectedSymbol = options.sfSelectedSymbol;
+    if (options.role.hasValue)
+        self.role = options.role;
 }
 
 - (BOOL)hasValue {
@@ -85,7 +88,7 @@
            self.iconColor.hasValue || self.selectedIconColor.hasValue ||
            self.selectedTextColor.hasValue || self.iconInsets.hasValue || self.textColor.hasValue ||
            self.visible.hasValue || self.selectTabOnPress.hasValue || self.sfSymbol.hasValue ||
-           self.sfSelectedSymbol.hasValue;
+           self.sfSelectedSymbol.hasValue || self.role.hasValue;
 }
 
 @end

package/ios/RNNBottomTabsController.mm

@@ -1,4 +1,5 @@
 #import "RNNBottomTabsController.h"
+#import "RNNTabBarItemCreator.h"
 #import "UITabBarController+RNNOptions.h"
 #import "UITabBarController+RNNUtils.h"
 
@@ -7,6 +8,8 @@
 @property(nonatomic, strong) RNNDotIndicatorPresenter *dotIndicatorPresenter;
 @property(nonatomic, strong) UILongPressGestureRecognizer *longPressRecognizer;
 
+- (void)rnn_cycleAllTabsThenRestoreInitialSelection;
+
 @end
 
 @implementation RNNBottomTabsController {
@@ -16,6 +19,8 @@
     BOOL _tabBarNeedsRestore;
     RNNNavigationOptions *_options;
     BOOL _didFinishSetup;
+    BOOL _rnnDidApplyInitialTabBarSelectionFix;
+    BOOL _rnnSuppressTabSelectionEvents;
 }
 
 - (instancetype)initWithLayoutInfo:(RNNLayoutInfo *)layoutInfo
@@ -49,12 +54,7 @@
                       eventEmitter:eventEmitter
               childViewControllers:childViewControllers];
 
-    if (@available(iOS 26.0, *)) {
-        UITabBarAppearance *appearance = [UITabBarAppearance new];
-        [appearance configureWithDefaultBackground];
-        self.tabBar.standardAppearance = appearance;
-        self.tabBar.scrollEdgeAppearance = [appearance copy];
-    } else if (@available(iOS 13.0, *)) {
+    if (@available(iOS 13.0, *)) {
         UITabBarAppearance *appearance = [UITabBarAppearance new];
         [appearance configureWithOpaqueBackground];
         appearance.backgroundEffect = nil;
@@ -90,11 +90,44 @@
     }
 }
 
-- (void)viewDidLoad {
-    [super viewDidLoad];
+- (void)viewDidAppear:(BOOL)animated {
+    [super viewDidAppear:animated];
+    // iOS 26: first layout can misplace tab item titles; cycling selection (then restoring) forces a
+    // correct layout without user interaction. Defer so all tab children are in the hierarchy.
+    if (@available(iOS 26.0, *)) {
+        if (!_rnnDidApplyInitialTabBarSelectionFix) {
+            _rnnDidApplyInitialTabBarSelectionFix = YES;
+            __weak RNNBottomTabsController *weakSelf = self;
+            dispatch_async(dispatch_get_main_queue(), ^{
+                [weakSelf rnn_cycleAllTabsThenRestoreInitialSelection];
+            });
+        }
+    }
+}
+
+- (void)rnn_cycleAllTabsThenRestoreInitialSelection {
+    NSUInteger count = self.childViewControllers.count;
+    if (count <= 1) {
+        return;
+    }
+
+    NSUInteger initial = _currentTabIndex;
+    if (initial >= count) {
+        initial = 0;
+    }
+
+    _rnnSuppressTabSelectionEvents = YES;
+    [UIView performWithoutAnimation:^{
+        for (NSUInteger i = 0; i < count; i++) {
+            [self setSelectedIndex:i];
+        }
+        [self setSelectedIndex:initial];
+    }];
+    _rnnSuppressTabSelectionEvents = NO;
 }
 
 - (void)createTabBarItems:(NSArray<UIViewController *> *)childViewControllers {
+    _bottomTabPresenter.tabCreator.searchRoleUsed = NO;
     for (UIViewController *child in childViewControllers) {
         [_bottomTabPresenter applyOptions:child.resolveOptions child:child];
     }
@@ -200,6 +233,9 @@
 
 - (void)tabBarController:(UITabBarController *)tabBarController
     didSelectViewController:(UIViewController *)viewController {
+    if (_rnnSuppressTabSelectionEvents) {
+        return;
+    }
     [self.eventEmitter sendBottomTabSelected:@(tabBarController.selectedIndex)
                                   unselected:@(_previousTabIndex)];
 }
@@ -216,6 +252,10 @@
     NSUInteger _index = [tabBarController.viewControllers indexOfObject:viewController];
     BOOL isMoreTab = ![tabBarController.viewControllers containsObject:viewController];
 
+    if (_rnnSuppressTabSelectionEvents) {
+        return YES;
+    }
+
     [self.eventEmitter sendBottomTabPressed:@(_index)];
 
     if ([[viewController resolveOptions].bottomTab.selectTabOnPress withDefault:YES] || isMoreTab) {

package/ios/RNNButtonOptions.h

@@ -23,6 +23,7 @@
 @property(nonatomic, strong) RNNComponentOptions *component;
 @property(nonatomic, strong) RNNIconBackgroundOptions *iconBackground;
 @property(nonatomic, strong) Bool *disableIconTint;
+@property(nonatomic, strong) Bool *hideSharedBackground;
 
 - (RNNButtonOptions *)withDefault:(RNNButtonOptions *)defaultOptions;
 

package/ios/RNNButtonOptions.mm

@@ -25,6 +25,7 @@
                                                                  enabled:self.enabled];
     self.systemItem = [TextParser parse:dict key:@"systemItem"];
     self.disableIconTint = [BoolParser parse:dict key:@"disableIconTint"];
+    self.hideSharedBackground = [BoolParser parse:dict key:@"hideSharedBackground"];
 
     return self;
 }
@@ -49,6 +50,7 @@
     newOptions.iconBackground = self.iconBackground.copy;
     newOptions.systemItem = self.systemItem.copy;
     newOptions.disableIconTint = self.disableIconTint.copy;
+    newOptions.hideSharedBackground = self.hideSharedBackground.copy;
     return newOptions;
 }
 
@@ -88,6 +90,8 @@
         self.systemItem = options.systemItem;
     if (options.disableIconTint.hasValue)
         self.disableIconTint = options.disableIconTint;
+    if (options.hideSharedBackground.hasValue)
+        self.hideSharedBackground = options.hideSharedBackground;
 }
 
 - (BOOL)shouldCreateCustomView {

package/ios/RNNComponentOptions.mm

@@ -9,7 +9,7 @@
     self.name = [TextParser parse:dict key:@"name"];
     self.componentId = [TextParser parse:dict key:@"componentId"];
     self.alignment = [TextParser parse:dict key:@"alignment"];
-	self.waitForRender = [Bool withValue:[[BoolParser parse:dict key:@"waitForRender"] withDefault:[RNNUtils getDefaultWaitForRender]]];
+    self.waitForRender = [BoolParser parse:dict key:@"waitForRender"];
 
     return self;
 }

package/ios/RNNComponentViewController.mm

@@ -155,6 +155,11 @@
                                     isFocused:searchController.searchBar.isFirstResponder];
 }
 
+- (void)destroyReactView {
+    [self.reactView removeFromSuperview];
+    self.reactView = nil;
+}
+
 - (void)screenPopped {
     [_eventEmitter sendScreenPoppedEvent:self.layoutInfo.componentId];
 }

package/ios/RNNScreenTransition.mm

@@ -11,7 +11,7 @@
     self.content = [[RNNEnterExitAnimation alloc] initWithDict:dict[@"content"]];
     self.bottomTabs = [[ElementTransitionOptions alloc] initWithDict:dict[@"bottomTabs"]];
     self.enable = [BoolParser parse:dict key:@"enabled"];
-	self.waitForRender = [Bool withValue: [[BoolParser parse:dict key:@"waitForRender"] withDefault: [RNNUtils getDefaultWaitForRender]]];
+    self.waitForRender = [BoolParser parse:dict key:@"waitForRender"];
     self.duration = [TimeIntervalParser parse:dict key:@"duration"];
     self.sharedElementTransitions = [OptionsArrayParser parse:dict
                                                           key:@"sharedElementTransitions"

package/ios/RNNStackController.mm

@@ -42,7 +42,82 @@
 
 - (UIViewController *)popViewControllerAnimated:(BOOL)animated {
     [self prepareForPop];
-    return [super popViewControllerAnimated:animated];
+    UIViewController *previousTop = self.topViewController;
+    UIView *snapshot = [self snapshotTopView:animated];
+
+    UIViewController *poppedVC = [super popViewControllerAnimated:animated];
+    if (!poppedVC) {
+        [snapshot removeFromSuperview];
+        return nil;
+    }
+
+    id<UIViewControllerTransitionCoordinator> coordinator = self.transitionCoordinator;
+    if (coordinator && coordinator.isInteractive) {
+        // Interactive pop (swipe-back): remove snapshot overlay — UIKit shows the live
+        // view during the gesture. Skip early teardown so the React view stays alive
+        // if the gesture is cancelled. The delegate's didShowViewController handles
+        // cleanup once the animation finishes.
+        [snapshot removeFromSuperview];
+    } else {
+        [self teardownPoppedControllers:@[ poppedVC ] previousTop:previousTop];
+    }
+    return poppedVC;
+}
+
+- (NSArray<UIViewController *> *)popToViewController:(UIViewController *)viewController
+                                             animated:(BOOL)animated {
+    UIViewController *previousTop = self.topViewController;
+    UIView *snapshot = [self snapshotTopView:animated];
+
+    NSArray<UIViewController *> *poppedVCs =
+        [super popToViewController:viewController animated:animated];
+    if (poppedVCs.count > 0) {
+        [self teardownPoppedControllers:poppedVCs previousTop:previousTop];
+    } else {
+        [snapshot removeFromSuperview];
+    }
+    return poppedVCs;
+}
+
+- (NSArray<UIViewController *> *)popToRootViewControllerAnimated:(BOOL)animated {
+    UIViewController *previousTop = self.topViewController;
+    UIView *snapshot = [self snapshotTopView:animated];
+
+    NSArray<UIViewController *> *poppedVCs =
+        [super popToRootViewControllerAnimated:animated];
+    if (poppedVCs.count > 0) {
+        [self teardownPoppedControllers:poppedVCs previousTop:previousTop];
+    } else {
+        [snapshot removeFromSuperview];
+    }
+    return poppedVCs;
+}
+
+#pragma mark - React view teardown
+
+- (UIView *)snapshotTopView:(BOOL)animated {
+    if (!animated) return nil;
+    UIViewController *topVC = self.topViewController;
+    if (!topVC.isViewLoaded || !topVC.view.window) return nil;
+
+    UIView *snapshot = [topVC.view snapshotViewAfterScreenUpdates:NO];
+    if (snapshot) {
+        snapshot.frame = topVC.view.bounds;
+        snapshot.autoresizingMask =
+            UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
+        [topVC.view addSubview:snapshot];
+    }
+    return snapshot;
+}
+
+- (void)teardownPoppedControllers:(NSArray<UIViewController *> *)poppedVCs
+                      previousTop:(UIViewController *)previousTop {
+    for (UIViewController *vc in poppedVCs) {
+        if (vc == previousTop && [vc isKindOfClass:[RNNComponentViewController class]]) {
+            [[(RNNComponentViewController *)vc reactView] componentDidDisappear];
+        }
+        [vc destroyReactView];
+    }
 }
 
 - (BOOL)navigationBar:(UINavigationBar *)navigationBar shouldPopItem:(UINavigationItem *)item {

package/ios/RNNTabBarItemCreator.h

@@ -4,6 +4,8 @@
 
 @interface RNNTabBarItemCreator : NSObject
 
+@property(nonatomic, assign) BOOL searchRoleUsed;
+
 - (UITabBarItem *)createTabBarItem:(RNNBottomTabOptions *)bottomTabOptions
                          mergeItem:(UITabBarItem *)mergeItem;
 

package/ios/RNNTabBarItemCreator.mm

@@ -1,15 +1,46 @@
 #import "RNNTabBarItemCreator.h"
 #import "RNNFontAttributesCreator.h"
 #import "UIImage+utils.h"
+#import <React/RCTLog.h>
 
 @implementation RNNTabBarItemCreator
 
++ (NSNumber *)systemItemForRole:(NSString *)role {
+    static NSDictionary<NSString *, NSNumber *> *map = nil;
+    static dispatch_once_t onceToken;
+    dispatch_once(&onceToken, ^{
+        map = @{
+            @"search"     : @(UITabBarSystemItemSearch),
+            @"bookmarks"  : @(UITabBarSystemItemBookmarks),
+            @"contacts"   : @(UITabBarSystemItemContacts),
+            @"downloads"  : @(UITabBarSystemItemDownloads),
+            @"favorites"  : @(UITabBarSystemItemFavorites),
+            @"featured"   : @(UITabBarSystemItemFeatured),
+            @"history"    : @(UITabBarSystemItemHistory),
+            @"more"       : @(UITabBarSystemItemMore),
+            @"mostRecent" : @(UITabBarSystemItemMostRecent),
+            @"mostViewed" : @(UITabBarSystemItemMostViewed),
+            @"recents"    : @(UITabBarSystemItemRecents),
+            @"topRated"   : @(UITabBarSystemItemTopRated),
+        };
+    });
+    return map[role];
+}
+
 - (UITabBarItem *)createTabBarItem:(UITabBarItem *)mergeItem {
     return mergeItem ?: [UITabBarItem new];
 }
 
 - (UITabBarItem *)createTabBarItem:(RNNBottomTabOptions *)bottomTabOptions
                          mergeItem:(UITabBarItem *)mergeItem {
+
+    if (bottomTabOptions.role.hasValue) {
+        UITabBarItem *roleItem = [self createSystemItemForRole:bottomTabOptions
+                                                     mergeItem:mergeItem];
+        if (roleItem)
+            return roleItem;
+    }
+
     UITabBarItem *tabItem = [self createTabBarItem:mergeItem];
     UIImage *icon = [bottomTabOptions.icon withDefault:nil];
     UIImage *selectedIcon = [bottomTabOptions.selectedIcon withDefault:icon];
@@ -55,6 +86,71 @@
     return tabItem;
 }
 
+#pragma mark - Role (system item) creation
+
+- (UITabBarItem *)createSystemItemForRole:(RNNBottomTabOptions *)bottomTabOptions
+                                mergeItem:(UITabBarItem *)mergeItem {
+    NSString *role = [bottomTabOptions.role withDefault:nil];
+    NSNumber *systemItemNumber = [RNNTabBarItemCreator systemItemForRole:role];
+
+    if (!systemItemNumber) {
+        RCTLogWarn(@"[RNN] Unknown bottomTab role '%@' — falling back to normal tab.", role);
+        return nil;
+    }
+
+    if ([role isEqualToString:@"search"] && self.searchRoleUsed) {
+        RCTLogWarn(@"[RNN] Only one tab per bottomTabs layout may use role:'search'. "
+                   @"Subsequent 'search' roles are ignored — creating a normal tab instead.");
+        return nil;
+    }
+
+    if ([role isEqualToString:@"search"]) {
+        self.searchRoleUsed = YES;
+    }
+
+    UITabBarItem *tabItem =
+        [[UITabBarItem alloc] initWithTabBarSystemItem:(UITabBarSystemItem)[systemItemNumber integerValue]
+                                                  tag:bottomTabOptions.tag];
+
+    UITabBarItem *baseItem = [self createTabBarItem:mergeItem];
+    tabItem.standardAppearance = baseItem.standardAppearance;
+#if __IPHONE_OS_VERSION_MAX_ALLOWED >= 150000
+    if (@available(iOS 15.0, *)) {
+        tabItem.scrollEdgeAppearance = baseItem.scrollEdgeAppearance;
+    }
+#endif
+
+    UIImage *icon = [bottomTabOptions.icon withDefault:nil];
+    UIImage *selectedIcon = [bottomTabOptions.selectedIcon withDefault:nil];
+    UIColor *iconColor = [bottomTabOptions.iconColor withDefault:nil];
+    UIColor *selectedIconColor = [bottomTabOptions.selectedIconColor withDefault:iconColor];
+
+    if (@available(iOS 13.0, *)) {
+        if (bottomTabOptions.sfSymbol.hasValue) {
+            icon = [UIImage systemImageNamed:[bottomTabOptions.sfSymbol withDefault:nil]];
+        }
+        if (bottomTabOptions.sfSelectedSymbol.hasValue) {
+            selectedIcon = [UIImage systemImageNamed:[bottomTabOptions.sfSelectedSymbol withDefault:nil]];
+        }
+    }
+
+    if (icon) {
+        tabItem.image = [self getIconImage:icon withTint:iconColor];
+    }
+    if (selectedIcon) {
+        tabItem.selectedImage = [self getSelectedIconImage:selectedIcon
+                                         selectedIconColor:selectedIconColor];
+    }
+
+    tabItem.accessibilityIdentifier = [bottomTabOptions.testID withDefault:nil];
+    tabItem.accessibilityLabel = [bottomTabOptions.accessibilityLabel withDefault:nil];
+    [self appendTitleAttributes:tabItem bottomTabOptions:bottomTabOptions];
+
+    return tabItem;
+}
+
+#pragma mark - Icon helpers
+
 - (UIImage *)getSelectedIconImage:(UIImage *)selectedIcon
                 selectedIconColor:(UIColor *)selectedIconColor {
     if (selectedIcon) {
@@ -82,6 +178,8 @@
     return nil;
 }
 
+#pragma mark - Title attributes
+
 - (void)appendTitleAttributes:(UITabBarItem *)tabItem
              bottomTabOptions:(RNNBottomTabOptions *)bottomTabOptions {
     UIColor *textColor = [bottomTabOptions.textColor withDefault:[UIColor blackColor]];

package/ios/RNNUIBarButtonItem.mm

@@ -71,6 +71,13 @@
     [button.widthAnchor constraintEqualToConstant:icon.size.width].active = YES;
     [button.heightAnchor constraintEqualToConstant:icon.size.height].active = YES;
     self = [super initWithCustomView:button];
+    if (@available(iOS 26.0, *)) {
+        // The UIButton already paints its own iconBackground chrome, so the
+        // iOS 26 shared Platter would double-decorate it. Defaults to YES;
+        // callers can opt back in via the hideSharedBackground option.
+        self.hidesSharedBackground =
+            [buttonOptions.hideSharedBackground withDefault:YES];
+    }
     [self applyOptions:buttonOptions];
     self.onPress = onPress;
     return self;
@@ -91,6 +98,25 @@
                      buttonOptions:(RNNButtonOptions *)buttonOptions
                            onPress:(RNNButtonPressCallback)onPress {
     self = [super initWithCustomView:reactView];
+    if (@available(iOS 26.0, *)) {
+        // iOS 26 wraps every bar button item in a shared Platter/Liquid-Glass
+        // background. React-rendered custom views supply their own chrome, and
+        // the Platter both double-decorates and misaligns custom views taller
+        // than the standard pill (~30pt). Defaults to YES; callers can opt
+        // back in via the hideSharedBackground option.
+        self.hidesSharedBackground =
+            [buttonOptions.hideSharedBackground withDefault:YES];
+        // Pin the custom view to a stable 44pt bar-item size so the navbar
+        // reserves the final slot up-front (incl. during push-transition
+        // snapshots) and doesn't relayout once React mounts. Without this,
+        // React's post-mount sizeToFit changes bounds, the navbar relayouts,
+        // and the customView visibly snaps from a 0x0 / wrong-position state
+        // to its centered final frame. React content centers within via its
+        // own flex layout.
+        reactView.translatesAutoresizingMaskIntoConstraints = NO;
+        [reactView.widthAnchor constraintEqualToConstant:44].active = YES;
+        [reactView.heightAnchor constraintEqualToConstant:44].active = YES;
+    }
     [self applyOptions:buttonOptions];
     self.onPress = onPress;
     return self;

package/ios/StackControllerDelegate.mm

@@ -56,6 +56,7 @@
     if (_presentedViewController &&
         ![navigationController.viewControllers containsObject:_presentedViewController]) {
         [_presentedViewController screenPopped];
+        [_presentedViewController destroyReactView];
         _isPopping = NO;
     }