TabBar

TabBar, a React Native component for iOS, Android and web: Bottom navigation, with an optional native variant.

Usage

import { useState } from 'react';
import { TabBar } from './components/ui/tabbar';

const ITEMS = [
  { value: 'home', label: 'Home', icon: 'home' as const },
  { value: 'orders', label: 'Orders', icon: 'shopping-bag' as const },
  { value: 'account', label: 'Account', icon: 'user' as const },
];

export default function Example() {
  const [tab, setTab] = useState('home');
  return <TabBar items={ITEMS} value={tab} onValueChange={setTab} />;
}

Props

PropTypeDefaultDescription
valuestring
labelstring'Main'
iconFeatherName | ImageSourcePropTypeA Feather icon name, or your own single-color artwork.
nativeIcon{ ios?: string; android?: string }Icon names for the platform tab bar: SF Symbols, Material icons.
testIDstring
itemsreadonly TabBarItem[]
valuestring
defaultValuestring
onValueChange(value: string) => void
labelstring'Main'Names the bar for screen readers.
styleStyleProp<ViewStyle>
testIDstring
nativebooleanRenders the real platform tab bar, Liquid Glass on iOS 26+, when `@leoanimesh/ferrule-native` is available.
barReactNodeThe `TabBar`.
childrenReactNode