- No native code
- Smooth animations
- Always stays on screen
- Fully customizable: the menu, the preview and the backdrop
- Opens above or below the content
- Opens on hold, tap or double tap
- RTL support
- Portrait and landscape support
Works with Expo and React Native CLI apps on the New Architecture.
Peer dependencies:
react>= 19react-native>= 0.86react-native-reanimated>= 4.7react-native-worklets>= 0.13react-native-gesture-handler>= 3.3
First install and set up the peer dependencies by following their official guides:
Then install the library:
# Expo
npx expo install react-native-peek-menu
# React Native CLI
npm install react-native-peek-menuWrap your app in PeekMenuProvider, then wrap anything that should open a menu in PeekMenu.
import { Text, View } from 'react-native';
import { PeekMenu, PeekMenuProvider } from 'react-native-peek-menu';
export default function App() {
return (
<PeekMenuProvider>
<PeekMenu
items={[
{ title: 'Reply', onPress: reply },
{ title: 'Copy', onPress: copy },
{ title: 'Delete', destructive: true, onPress: remove },
]}
>
<View>
<Text>Hold me</Text>
</View>
</PeekMenu>
</PeekMenuProvider>
);
}Pass the safe area so the menu keeps clear of the notch and the home indicator.
If a header, an input bar or a tab bar covers the top or bottom of the screen, even a translucent one, pass how much of it they cover as clipInsets. The menu opens between them, and content partly hidden under them opens and closes smoothly.
import { PeekMenu, PeekMenuProvider } from 'react-native-peek-menu';
import { useSafeAreaInsets } from 'react-native-safe-area-context';
function App() {
const insets = useSafeAreaInsets();
return (
<PeekMenuProvider safeAreaInsets={insets}>
<Chat />
</PeekMenuProvider>
);
}
function ChatMessage({ message, headerHeight, inputBarHeight }: ChatMessageProps) {
return (
<PeekMenu items={items} clipInsets={{ top: headerHeight, bottom: inputBarHeight }}>
<Bubble message={message} />
</PeekMenu>
);
}To open menus above modals on iOS, pass FullWindowOverlay from react-native-screens.
import { Platform } from 'react-native';
import { PeekMenuProvider } from 'react-native-peek-menu';
import { FullWindowOverlay } from 'react-native-screens';
function App() {
return (
<PeekMenuProvider overlayContainer={Platform.OS === 'ios' ? FullWindowOverlay : undefined}>
<Navigation />
</PeekMenuProvider>
);
}On Android, wrap the content of a Modal in its own PeekMenuProvider.
Replace the dimmed layer behind the menu with your own, like a blur that fades in and out with the menu.
import { BlurView } from 'expo-blur';
import { StyleSheet } from 'react-native';
import { PeekMenuProvider, type PeekMenuBackdropProps } from 'react-native-peek-menu';
import Animated, { useAnimatedProps } from 'react-native-reanimated';
const AnimatedBlurView = Animated.createAnimatedComponent(BlurView);
function BlurBackdrop({ progress }: PeekMenuBackdropProps) {
const animatedProps = useAnimatedProps(() => ({
intensity: Math.min(progress.get(), 1) * 40,
}));
return (
<AnimatedBlurView tint="dark" animatedProps={animatedProps} style={StyleSheet.absoluteFill} />
);
}
function App() {
return (
<PeekMenuProvider renderBackdrop={(props) => <BlurBackdrop {...props} />}>
<Chat />
</PeekMenuProvider>
);
}On Android, BlurView shows a tinted layer instead of a blur unless you set up blurTarget, as described in the expo-blur docs.
Restyle the list to match your app. Set renderMenu on PeekMenuProvider for every menu, or on a PeekMenu for one. Rows call onItemPress, which closes the menu and runs the item's onPress.
import { Pressable, StyleSheet, Text, View } from 'react-native';
import { PeekMenuProvider, type PeekMenuRenderProps } from 'react-native-peek-menu';
function BrandMenu({ items, onItemPress }: PeekMenuRenderProps) {
return (
<View style={styles.menu}>
{items.map((item) => (
<Pressable key={item.title} onPress={() => onItemPress(item)} style={styles.row}>
<Text style={[styles.title, item.destructive && styles.destructive]}>{item.title}</Text>
</Pressable>
))}
</View>
);
}
function App() {
return (
<PeekMenuProvider renderMenu={(props) => <BrandMenu {...props} />}>
<Chat />
</PeekMenuProvider>
);
}
const styles = StyleSheet.create({
menu: {
width: 240,
maxWidth: '100%',
borderRadius: 20,
backgroundColor: '#1E1B4B',
},
row: {
padding: 14,
},
title: {
color: '#EEF2FF',
},
destructive: {
color: '#FCA5A5',
},
});A custom menu needs a width, and maxWidth: '100%' keeps it on small screens.
renderMenu can show any element instead of the list, like a row of reactions. Call close when it's done and pass it the action to run.
import { Pressable, StyleSheet, Text, View } from 'react-native';
import { PeekMenu } from 'react-native-peek-menu';
const REACTIONS = ['โค๏ธ', '๐', '๐', '๐ฎ', '๐ข'];
function Reactions({ onSelect }: { onSelect: (emoji: string) => void }) {
return (
<View style={styles.reactions}>
{REACTIONS.map((emoji) => (
<Pressable key={emoji} onPress={() => onSelect(emoji)} style={styles.reaction}>
<Text style={styles.emoji}>{emoji}</Text>
</Pressable>
))}
</View>
);
}
function ChatMessage({ message }: { message: Message }) {
return (
<PeekMenu
renderMenu={({ close }) => (
<Reactions onSelect={(emoji) => close(() => react(message.id, emoji))} />
)}
>
<Bubble message={message} />
</PeekMenu>
);
}
const styles = StyleSheet.create({
reactions: {
flexDirection: 'row',
gap: 4,
padding: 6,
borderRadius: 28,
backgroundColor: '#FFF',
},
reaction: {
padding: 6,
},
emoji: {
fontSize: 28,
},
});If the content reads a context, like a theme, pass what it needs through preview.
import { PeekMenu } from 'react-native-peek-menu';
function ThemedBubble({ message }: { message: Message }) {
const theme = useTheme();
return <Bubble message={message} theme={theme} />;
}
function ChatMessage({ message }: { message: Message }) {
const theme = useTheme();
return (
<PeekMenu items={items} preview={<Bubble message={message} theme={theme} />}>
<ThemedBubble message={message} />
</PeekMenu>
);
}| Prop | Type | Default | Description |
|---|---|---|---|
children |
ReactNode |
required | The part of the app that can open menus. |
safeAreaInsets |
PeekMenuInsets |
All 0 |
Space to keep clear on each side. |
colorScheme |
'system' | 'light' | 'dark' |
'system' |
The theme of the default menu. 'system' follows the device. |
backdropColor |
string |
'rgba(10, 14, 20, 0.5)' |
Color of the layer behind the menu. |
renderBackdrop |
(props: PeekMenuBackdropProps) => ReactNode |
Replaces that layer, and backdropColor is ignored. |
|
renderMenu |
(props: PeekMenuRenderProps) => ReactNode |
Renders every menu. A PeekMenu can override it with its own. |
|
overlayContainer |
ComponentType<{ children: ReactNode }> |
Shows the open menu inside this component, like FullWindowOverlay to keep it above modals on iOS. |
A PeekMenu needs items, renderMenu, or both.
| Prop | Type | Default | Description |
|---|---|---|---|
children |
ReactNode |
required | The content that opens the menu, held by default. |
items |
PeekMenuItem[] |
[] |
The rows, read when the menu opens. An empty list stops it from opening, unless there's a renderMenu. |
renderMenu |
(props: PeekMenuRenderProps) => ReactNode |
Renders this menu instead of the default list. | |
preview |
ReactNode |
Shown instead of the copy of children. |
|
placement |
'top' | 'bottom' |
'bottom' |
The side of the content the menu opens on. |
alignment |
'auto' | 'start' | 'center' | 'end' |
'auto' |
Where the menu lines up with the content. 'start' and 'end' follow the layout direction. |
clipInsets |
{ top?: number; bottom?: number } |
How much of the top and bottom is covered by something, opaque or translucent, like a header or an input bar. | |
activateOn |
'hold' | 'tap' | 'double-tap' |
'hold' |
How the content opens the menu. With a tap, the content shouldn't handle presses itself. |
holdDuration |
number |
300 |
How long to hold, in milliseconds. Only used with activateOn set to 'hold'. |
disabled |
boolean |
false |
Stops the content from opening the menu. |
style |
StyleProp<ViewStyle> |
Layout of the wrapper, like margin or alignSelf. |
|
onOpen |
() => void |
Called when the menu starts to open. | |
onClose |
() => void |
Called once the menu has finished closing. |
| Field | Type | Default | Description |
|---|---|---|---|
title |
string |
required | Text shown in the row. |
onPress |
() => void |
required | Called when the row is pressed, as the menu starts to close. |
destructive |
boolean |
false |
Shows the title in red, for actions like Delete. |
disabled |
boolean |
false |
Shows the row dimmed and stops it from being pressed. |
icon |
ReactNode |
Any element to show beside the title. | |
iconPosition |
'left' | 'right' |
'right' |
The side of the row the icon sits on. |
What renderMenu receives.
| Field | Type | Description |
|---|---|---|
items |
PeekMenuItem[] |
The rows of the open menu, empty if it has none. |
onItemPress |
(item: PeekMenuItem) => void |
Closes the menu and calls the item's onPress. Skips disabled items. |
close |
(action?: () => void) => void |
Closes the menu and runs action once. |
progress |
SharedValue<number> |
From 0 when closed to 1 when open. The open spring can pass 1 slightly. |
What renderBackdrop receives: progress, the same value as above.
MIT

