About this project

React Native Bottom Sheet (@gorhom/bottom-sheet) is an open-source UI component library for React Native that provides a performant, interactive bottom sheet with fully configurable options. It is written in TypeScript, ships with type definitions, and is compatible with Expo as well as React Native Web. Core capabilities include smooth gesture interactions and snapping animations, dynamic sizing, modal presentation via a Bottom Sheet Modal, and seamless keyboard handling on both iOS and Android. The library integrates with common scrollable components such as FlatList, SectionList, ScrollView, and View, supports pull-to-refresh for scrollables, and includes a dedicated BottomSheetFlashList component for FlashList usage. It also offers React Navigation integration and accessibility support. The project is maintained across multiple major versions tied to different Reanimated releases: v5 (current, master branch) is built on Reanimated v3 and Gesture Handler v2; v4 targets Reanimated v2; and v2 targets Reanimated v1 with Reanimated v2 compatibility. The author recommends v5 for the most stability and latest features. Documentation is hosted at gorhom.dev/react-native-bottom-sheet, and the library is released under the MIT license.