gorhom /react-native-bottom-sheet
A performant interactive bottom sheet with fully configurable options 🚀
★ 9,111⑂ 962👁 26⑃ 563● 2,000▤ 128
+0
日增长
9,111
stars
962
forks
26
watchers
563
prs
2,000
issues
128
releases
README
React Native Bottom Sheet
!NPM Downloads
A performant interactive bottom sheet with fully configurable options 🚀
!React Native Bottom Sheet
---
Features
- ⭐️ Support React Native Web, read more.
- ⭐️ Dynamic Sizing, read more.
- ⭐️ Support FlashList, read more.
- Modal presentation view, Bottom Sheet Modal.
- Smooth gesture interactions & snapping animations.
- Seamless keyboard handling for iOS & Android.
- Support pull to refresh for scrollables.
- Support FlatList, SectionList, ScrollView & View scrolling interactions, read more.
- Support React Navigation Integration, read more.
- Compatible with Reanimated v1-3.
- Compatible with Expo.
- Accessibility support.
- Written in TypeScript.
- Read more.
Getting Started
Check out the documentation website.
Versioning
This library been written in 3 versions of Reanimated, and kept all implementation in separate branches:
- v5 | branch | changelog : written with Reanimated v3 & Gesture Handler v2.
- v4 (not maintained) | branch | changelog : written with Reanimated v2.
- v2 (not maintained) | branch | changelog : written with Reanimated v1 & compatible with Reanimated v2.
I highly recommend to use v5 which provides more stability with all latest features.
Author
- Mo Gorhom
Sponsor & Support
To keep this library maintained and up-to-date please consider sponsoring it on GitHub. Or if you are looking for a private support or help in customizing the experience, then reach out to me on Twitter @gorhom.
License
MIT
---Top issues
#641[v4] Request: smoother keyboard transition when the bottom sheet is dismissed programmatically125 comments · 2021-09-14#1602[v4] | Keyboard causing bottom-sheet to close down completely when using enableDynamicSizing (Android only)78 comments · 2023-10-30#618[v4] BottomSheetScrollView causes extra padding to appear45 comments · 2021-09-02#1934[v4][v5] [Android] | TextInput at the bottom of a scroll view falls behind keyboard44 comments · 2024-09-12#1983Address reanimated API misuse warnings that pop up starting with reanimated 3.16.040 comments · 2024-10-18#1024Auto snap to dynamic content sections36 comments · 2022-07-07#436dynamic snap points cause flickering of backdrop24 comments · 2021-05-10#1824[v4] app crash in release mode ( IOS & ANDROID ) 22 comments · 2024-05-03
Discussions
#2769How to disable panning when deep in navigation tree1 comments · 2026-10-09#2768sheet-scope: promise-based, typed, lazily-mounted sheet manager built on gorhom v50 comments · 2026-10-06#2645How can we get this library maintained again0 comments · 2026-04-08#2641Reanimated v43 comments · 2026-03-27#2634How to create airbnb search result bottom-sheet effect?2 comments · 2026-03-16#2617Maximum call stack size exceeded (native stack depth) RangeError: Maximum call stack size exceeded (native stack depth) at gorhom_useScrollEventsHandlersDefaultTs11 comments · 2026-02-25#2611On load not able to touch in screen.0 comments · 2026-01-31#2587Can I make the bottom sheet slide in from somewhere that is not the screen edge?0 comments · 2025-12-10
Latest release
Release 5.2.14 v5.2.14 2026-05-095.2.14 (2026-05-09) 🐛 Bug Fixes allow mount animation alongside keyboard during initial open (2661) (2665)(by @huextrat) (782e00c), closes 2655 read window height from a shared value on ui thread (5853f11)