@lodev09/react-native-true-sheet

React Native True Sheet

[!NOTE] 🎉 Version 3.0 is here! Completely rebuilt for Fabric with new features like automatic ScrollView detection, native headers/footers, sheet stacking, and more. Read the announcement

The true native bottom sheet experience for your React Native Apps. 💩

Features

• ⚡ Powered by Fabric - Built on React Native's new architecture for maximum performance
• 🚀 Fully Native - Implemented in the native realm, zero JS hacks
• ♿ Accessible - Native accessibility and screen reader support out of the box
• 🔄 Flexible API - Use imperative methods or lifecycle events
• 🪟 Liquid Glass - iOS 26+ Liquid Glass support out of the box, featured in Expo Blog
• 🐎 Reanimated - First-class support for react-native-reanimated
• 🧭 React Navigation - Built-in sheet navigator for seamless navigation integration
• 🌐 Web Support - Full web support out of the box

Installation

[!IMPORTANT] Version 3.0+ requires React Native's New Architecture (Fabric) For the old architecture, use version 2.x. See the Migration Guide for upgrading.

Prerequisites

• React Native >= 0.76 (Expo SDK 52+)
• New Architecture enabled (default in RN 0.76+)
• Xcode 26.2 (strongly recommended for better library functionality)

Expo

npx expo install @lodev09/react-native-true-sheet

Bare React Native

yarn add @lodev09/react-native-true-sheet
cd ios && pod install

EAS Build (iOS)

When using EAS Build to build your iOS app, you must configure your eas.json to use a build image that includes Xcode 26.2. Use "image": "latest" or choose from the available build images:

{
  "build": {
    "production": {
      "ios": {
        "image": "latest"
      }
    },
    "development": {
      "ios": {
        "image": "latest"
      }
    }
  }
}

Documentation

• Example
• Configuration
• Lifecycle Events
• React Navigation
• Troubleshooting
• Testing with Jest
• Migrating to v3

Usage

import { TrueSheet } from "@lodev09/react-native-true-sheet"

export const App = () => {
  const sheet = useRef<TrueSheet>(null)

  // Present the sheet ✅
  const present = async () => {
    await sheet.current?.present()
    console.log('horray! sheet has been presented 💩')
  }

  // Dismiss the sheet ✅
  const dismiss = async () => {
    await sheet.current?.dismiss()
    console.log('Bye bye 👋')
  }

  return (
    <View>
      <Button onPress={present} title="Present" />
      <TrueSheet
        ref={sheet}
        detents={['auto', 1]}
      >
        <Button onPress={dismiss} title="Dismiss" />
      </TrueSheet>
    </View>
  )
}

Testing

TrueSheet exports mocks for easy testing:

// Main component
jest.mock('@lodev09/react-native-true-sheet', () =>
  require('@lodev09/react-native-true-sheet/mock')
);

// Navigation (if using)
jest.mock('@lodev09/react-native-true-sheet/navigation', () =>
  require('@lodev09/react-native-true-sheet/navigation/mock')
);

// Reanimated (if using)
jest.mock('@lodev09/react-native-true-sheet/reanimated', () =>
  require('@lodev09/react-native-true-sheet/reanimated/mock')
);

All methods (present, dismiss, resize) are mocked as Jest functions, allowing you to test your components without native dependencies.

Full Testing Guide

Contributing

See the contributing guide to learn how to contribute to the repository and the development workflow.

License

MIT

Made with ❤️ by @lodev09