feat: add per-tab icon sizing

Author: thiagobrez

.changeset/tall-icons-grow.md

@@ -0,0 +1,6 @@
+---
+'react-native-bottom-tabs': minor
+'@bottom-tabs/react-navigation': minor
+---
+
+Add a per-screen option for customizing tab image icon size.

apps/example/src/Examples/NativeBottomTabsOriginalIcons.tsx

@@ -21,6 +21,7 @@ export default function NativeBottomTabsOriginalIcons() {
         component={Contacts}
         options={{
           tabBarIcon: () => require('../../assets/avatar-1.png'),
+          tabBarIconSize: 34,
           tabBarIconRenderingMode: 'original',
         }}
       />

artifacts/issue-561/README.md

@@ -0,0 +1,15 @@
+# Issue 561 device verification
+
+Captured with `agent-device` 0.20.10 against the example app's **Native Bottom Tabs with original icons** screen.
+
+- iOS: iPhone 17 Pro simulator, iOS 26.5. The Avatar tab uses `tabBarIconSize: 34`; neighboring image tabs retain the existing 27 pt default.
+- Android: Pixel 10 Pro emulator, Android API 37 at 3x density. The final accessibility hierarchy measured the Avatar image at 102x102 px (34 dp) and the default Chat image at 72x72 px (24 dp).
+
+Artifacts:
+
+- `ios-tab-icon-size.png` and `ios-tab-icon-size-selected.png`
+- `ios-tab-icon-size.mp4`
+- `android-tab-icon-size.png`
+- `android-tab-icon-size.mp4`
+- `android-avatar-hierarchy.txt` and `android-default-hierarchy.txt`
+- `*-gesture-telemetry.json`

artifacts/issue-561/android-avatar-hierarchy.txt

@@ -0,0 +1,10 @@
+Page: bottomtabs.example
+App: bottomtabs.example
+Snapshot: 7 nodes
+{"index":0,"type":"android.widget.FrameLayout","label":"Avatar","bundleId":"bottomtabs.example","rect":{"x":320,"y":2613,"width":320,"height":171},"enabled":true,"visibleToUser":true,"hittable":true,"depth":0,"ref":"e1"}
+{"index":1,"type":"android.widget.LinearLayout","identifier":"bottomtabs.example:id/navigation_bar_item_content_container","bundleId":"bottomtabs.example","rect":{"x":425,"y":2637,"width":110,"height":147},"enabled":true,"visibleToUser":true,"depth":1,"parentIndex":0,"ref":"e2"}
+{"index":2,"type":"android.widget.FrameLayout","identifier":"bottomtabs.example:id/navigation_bar_item_icon_container","bundleId":"bottomtabs.example","rect":{"x":429,"y":2637,"width":102,"height":102},"enabled":true,"visibleToUser":true,"depth":2,"parentIndex":1,"ref":"e3"}
+{"index":3,"type":"android.widget.LinearLayout","identifier":"bottomtabs.example:id/navigation_bar_item_inner_content_container","bundleId":"bottomtabs.example","rect":{"x":429,"y":2637,"width":102,"height":102},"enabled":true,"visibleToUser":true,"depth":3,"parentIndex":2,"ref":"e4"}
+{"index":4,"type":"android.widget.ImageView","identifier":"bottomtabs.example:id/navigation_bar_item_icon_view","bundleId":"bottomtabs.example","rect":{"x":429,"y":2637,"width":102,"height":102},"enabled":true,"visibleToUser":true,"depth":4,"parentIndex":3,"ref":"e5"}
+{"index":5,"type":"android.view.ViewGroup","identifier":"bottomtabs.example:id/navigation_bar_item_labels_group","bundleId":"bottomtabs.example","rect":{"x":425,"y":2742,"width":110,"height":42},"enabled":true,"visibleToUser":true,"depth":2,"parentIndex":1,"ref":"e6"}
+{"index":6,"type":"android.widget.TextView","label":"Avatar","value":"Avatar","identifier":"bottomtabs.example:id/navigation_bar_item_small_label_view","bundleId":"bottomtabs.example","rect":{"x":425,"y":2742,"width":109,"height":42},"enabled":true,"visibleToUser":true,"depth":3,"parentIndex":5,"ref":"e7"}

artifacts/issue-561/android-default-hierarchy.txt

@@ -0,0 +1,10 @@
+Page: bottomtabs.example
+App: bottomtabs.example
+Snapshot: 7 nodes
+{"index":0,"type":"android.widget.FrameLayout","label":"Chat","bundleId":"bottomtabs.example","rect":{"x":960,"y":2613,"width":320,"height":171},"enabled":true,"visibleToUser":true,"hittable":true,"depth":0,"ref":"e1"}
+{"index":1,"type":"android.widget.LinearLayout","identifier":"bottomtabs.example:id/navigation_bar_item_content_container","bundleId":"bottomtabs.example","rect":{"x":1080,"y":2637,"width":79,"height":117},"enabled":true,"visibleToUser":true,"depth":1,"parentIndex":0,"ref":"e2"}
+{"index":2,"type":"android.widget.FrameLayout","identifier":"bottomtabs.example:id/navigation_bar_item_icon_container","bundleId":"bottomtabs.example","rect":{"x":1083,"y":2637,"width":72,"height":72},"enabled":true,"visibleToUser":true,"depth":2,"parentIndex":1,"ref":"e3"}
+{"index":3,"type":"android.widget.LinearLayout","identifier":"bottomtabs.example:id/navigation_bar_item_inner_content_container","bundleId":"bottomtabs.example","rect":{"x":1083,"y":2637,"width":72,"height":72},"enabled":true,"visibleToUser":true,"depth":3,"parentIndex":2,"ref":"e4"}
+{"index":4,"type":"android.widget.ImageView","identifier":"bottomtabs.example:id/navigation_bar_item_icon_view","bundleId":"bottomtabs.example","rect":{"x":1083,"y":2637,"width":72,"height":72},"enabled":true,"visibleToUser":true,"depth":4,"parentIndex":3,"ref":"e5"}
+{"index":5,"type":"android.view.ViewGroup","identifier":"bottomtabs.example:id/navigation_bar_item_labels_group","bundleId":"bottomtabs.example","rect":{"x":1080,"y":2712,"width":79,"height":42},"enabled":true,"visibleToUser":true,"depth":2,"parentIndex":1,"ref":"e6"}
+{"index":6,"type":"android.widget.TextView","label":"Chat","value":"Chat","identifier":"bottomtabs.example:id/navigation_bar_item_small_label_view","bundleId":"bottomtabs.example","rect":{"x":1080,"y":2712,"width":79,"height":42},"enabled":true,"visibleToUser":true,"depth":3,"parentIndex":5,"ref":"e7"}

artifacts/issue-561/android-tab-icon-size.gesture-telemetry.json

@@ -0,0 +1,22 @@
+{
+  "version": 1,
+  "generatedAt": "2026-08-24T20:37:38.885Z",
+  "events": [
+    {
+      "kind": "tap",
+      "tMs": 638,
+      "x": 480,
+      "y": 2699,
+      "referenceWidth": 1280,
+      "referenceHeight": 2856
+    },
+    {
+      "kind": "tap",
+      "tMs": 6687,
+      "x": 1120,
+      "y": 2699,
+      "referenceWidth": 1280,
+      "referenceHeight": 2856
+    }
+  ]
+}

artifacts/issue-561/android-tab-icon-size.mp4

@@ -0,0 +1,30 @@
+{
+  "version": 1,
+  "generatedAt": "2026-08-24T20:32:29.204Z",
+  "events": [
+    {
+      "kind": "tap",
+      "tMs": 4578.965576171875,
+      "x": 201,
+      "y": 489,
+      "referenceWidth": 402,
+      "referenceHeight": 874
+    },
+    {
+      "kind": "tap",
+      "tMs": 23342.7021484375,
+      "x": 159,
+      "y": 822,
+      "referenceWidth": 402,
+      "referenceHeight": 874
+    },
+    {
+      "kind": "tap",
+      "tMs": 29424.4873046875,
+      "x": 328,
+      "y": 822,
+      "referenceWidth": 402,
+      "referenceHeight": 874
+    }
+  ]
+}