feat: add docs

Author: okwasniewski

.changeset/ready-paths-train.md

@@ -0,0 +1,5 @@
+---
+'react-native-bottom-tabs': patch
+---
+
+feat: implement iOS 26 minimizeBehavior feature

docs/docs/docs/guides/standalone-usage.md

@@ -47,6 +47,7 @@ export default function TabViewExample() {
       renderScene={renderScene}
       onIndexChange={setIndex}
       labeled
+      minimizeBehavior="onScrollDown" // iOS 26+: Hide tab bar when scrolling down
     />
   );
 }
@@ -143,6 +144,22 @@ Supported properties:
 Appearance attributes for the tab bar when a scroll view is at the bottom.
 - Type: `'default' | 'opaque' | 'transparent'`
 
+#### `minimizeBehavior` <Badge text="iOS 26+" type="info" />
+
+Controls how the tab bar behaves when content is scrolled.
+- Type: `'automatic' | 'onScrollDown' | 'onScrollUp' | 'never'`
+- Default: `undefined` (uses system default)
+
+Options:
+- `automatic`: Platform determines the behavior
+- `onScrollDown`: Tab bar minimizes when scrolling down
+- `onScrollUp`: Tab bar minimizes when scrolling up  
+- `never`: Tab bar never minimizes
+
+:::note
+This feature requires iOS 26.0 or later and is only available on iOS. On older versions, this prop is ignored.
+:::
+
 #### `tabBarActiveTintColor`
 
 Color for the active tab.

docs/docs/docs/guides/usage-with-react-navigation.mdx

@@ -158,6 +158,23 @@ Tab views using the sidebar adaptable style have an appearance
 
 Whether to enable haptic feedback on tab press. Defaults to false.
 
+#### `minimizeBehavior` <Badge text="iOS 26+" type="info" />
+
+Controls how the tab bar behaves when content is scrolled.
+
+- Type: `'automatic' | 'onScrollDown' | 'onScrollUp' | 'never'`
+- Default: `undefined` (uses system default)
+
+Options:
+- `automatic`: Platform determines the behavior
+- `onScrollDown`: Tab bar minimizes when scrolling down
+- `onScrollUp`: Tab bar minimizes when scrolling up  
+- `never`: Tab bar never minimizes
+
+:::note
+This feature requires iOS 26.0 or later and is only available on iOS. On older versions, this prop is ignored.
+:::
+
 #### `tabLabelStyle`
 
 Object containing styles for the tab label.

packages/react-native-bottom-tabs/android/src/newarch/RCTTabViewManager.kt

@@ -163,4 +163,7 @@ class RCTTabViewManager(context: ReactApplicationContext) :
 
   override fun setScrollEdgeAppearance(view: ReactBottomNavigationView?, value: String?) {
   }
+
+  override fun setMinimizeBehavior(view: ReactBottomNavigationView?, value: String?) {
+  }
 }

packages/react-native-bottom-tabs/android/src/oldarch/RCTTabViewManager.kt

@@ -137,6 +137,10 @@ class RCTTabViewManager(context: ReactApplicationContext) : ViewGroupManager<Rea
   fun setSidebarAdaptable(view: ReactBottomNavigationView, flag: Boolean) {
   }
 
+  @ReactProp(name = "minimizeBehavior")
+  fun setMinimizeBehavior(view: ReactBottomNavigationView, flag: Boolean) {
+  }
+
   @ReactProp(name = "hapticFeedbackEnabled")
   fun setHapticFeedbackEnabled(view: ReactBottomNavigationView, value: Boolean) {
       tabViewImpl.setHapticFeedbackEnabled(view, value)

packages/react-native-bottom-tabs/ios/TabViewImpl.swift

@@ -336,6 +336,7 @@ extension View {
 
   @ViewBuilder
   func tabBarMinimizeBehavior(_ behavior: MinimizeBehavior?) -> some View {
+#if compiler(>=6.2)
     if #available(iOS 26.0, *) {
       if let behavior {
         self.tabBarMinimizeBehavior(behavior.convert())
@@ -345,6 +346,9 @@ extension View {
     } else {
       self
     }
+#else
+    self
+#endif
   }
 
   @ViewBuilder

packages/react-native-bottom-tabs/ios/TabViewProps.swift

@@ -6,6 +6,7 @@ internal enum MinimizeBehavior: String {
   case onScrollUp
   case onScrollDown
 
+#if compiler(>=6.2)
   @available(iOS 26.0, *)
   func convert() -> TabBarMinimizeBehavior {
     switch self {
@@ -19,6 +20,7 @@ internal enum MinimizeBehavior: String {
       return .onScrollDown
     }
   }
+#endif
 }
 
 /**