react-native-true-sheet
The true native bottom sheet experience π©
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/lodev09/react-native-true-sheet with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/lodev09/react-native-true-sheet'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/lodev09--react-native-true-sheet)HTML
<a href="/listings/lodev09--react-native-true-sheet"><img src="/api/listings/lodev09--react-native-true-sheet/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
> [!IMPORTANT] > **Version 3.0+ requires React Native's New Architecture (Fabric)** > For the old architecture, use version 2.x. See the [Migration Guide](https://sheet.lodev09.com/migration) for upgrading.
Prerequisites
- React Native 0.82+ (0.81+ on v3) - New Architecture enabled - Xcode 26.1+
Compatibility
| TrueSheet | React Native | Expo SDK | |------------|--------------|----------| | 4.0+ | 0.82+ | 55+ | | 3.7 - 3.11 | 0.81-0.86 | 54-57 | | 3.6 | 0.80 | 52-53 |
Expo
npx expo install @lodev09/react-native-true-sheet
Bare React Native
yarn add @lodev09/react-native-true-sheet cd ios && pod install
These install v3. For v4, append `@beta` β see [π What's New in v4](#-whats-new-in-v4).
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md Β· README Β· 141 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # React Native TrueSheet
- [](https://github.com/lodev09/react-native-true-sheet/actions/workflows/checks.yml)
- [](https://www.npmjs.com/package/@lodev09/react-native-true-sheet)
- The true native bottom sheet experience for your React Native Apps. π©
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="docs/public/img/previews/preview-ios-dark.gif" />
- <img alt="React Native True Sheet - iOS" src="docs/public/img/previews/preview-ios-light.gif" height="439" />
- </picture>
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="docs/public/img/previews/preview-android-dark.gif" />
- <img alt="React Native True Sheet - Android" src="docs/public/img/previews/preview-android-light.gif" height="439" />
- </picture>
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="docs/public/img/previews/preview-web-dark.gif" />
- <img alt="React Native True Sheet - Web" src="docs/public/img/previews/preview-web-light.gif" height="439" />
- </picture>
- ## 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](https://sheet.lodev09.com/reference/methods#component-methods) or [lifecycle events](https://sheet.lodev09.com/reference/events)
- * β¨οΈ **Keyboard Handling** - Built-in [keyboard handling](https://sheet.lodev09.com/guides/keyboard) with automatic adjustment
- * π **Side Sheets** - Native [side sheet](https://sheet.lodev09.com/guides/side-sheets) support for iPad and Android tablets
- * π¨ **Backgrounds** - Colors, blur, glass tints, and [per-detent backgrounds](https://sheet.lodev09.com/guides/backgrounds) on all platforms
- * π **Overlays** - Render toasts and dialogs [above your sheets](https://sheet.lodev09.com/guides/overlays) with `TrueSheetOverlay`
- * π± **Foldables** - [Rest the sheet on the hinge](https://sheet.lodev09.com/guides/foldables) of a half-folded iPhone (iOS 27.1+)
- * πͺ **Liquid Glass** - [iOS 26+ Liquid Glass](https://sheet.lodev09.com/guides/liquid-glass) support out of the box, featured in [Expo Blog](https://expo.dev/blog/how-to-create-apple-maps-style-liquid-glass-sheets)
- * π **Reanimated** - First-class support for [react-native-reanimated](https://sheet.lodev09.com/guides/reanimated)
- * π§ **React Navigation & Expo Router** - Built-in [sheet navigator](https://sheet.lodev09.com/guides/navigation) and [Expo Router `Sheet` layout](https://sheet.lodev09.com/guides/navigation#expo-router)
- * π **Web Support** - Full [web support](https://sheet.lodev09.com/guides/web) out of the box
- ## π True Sheet 4.0 is here!
- > [!TIP]
- > v4 rewrites the layout engine β the sheet now lays out synchronously per detent and tracks its visible height in realtime while dragging. Read the [announcement](https://sheet.lodev09.com/blog/release-4-0) and see the [Migration Guide](https://sheet.lodev09.com/migration) to upgrade.
- ## Installation
- ### Prerequisites
- - React Native 0.82+
- - New Architecture enabled
- - Xcode 26.1+
- ### Compatibility
- | TrueSheet | React Native | Expo SDK |
- |------------|--------------|----------|
- | 4.0+ | 0.82+ | 55+ |
- | 3.7 - 3.11 | 0.81-0.86 | 54-57 |
- | 3.6 | 0.80 | 52-53 |
- ### Expo
- ```sh
- npx expo install @lodev09/react-native-true-sheet
- ```
- ### Bare React Native
- ```sh
- yarn add @lodev09/react-native-true-sheet
- cd ios && pod install
- ```
- On apps using React Native's Swift Package Manager setup (React Native 0.88+), run `npx react-native spm` instead of `pod install`.
- ## Documentation
- - [Example](example)
- - [Configuration](https://sheet.lodev09.com/reference/configuration)
- - [Lifecycle Events](https://sheet.lodev09.com/reference/events)
- - [React Navigation & Expo Router](https://sheet.lodev09.com/guides/navigation)
- - [Troubleshooting](https://sheet.lodev09.com/troubleshooting)
- - [Testing with Jest](https://sheet.lodev09.com/guides/jest)
- - [Migrating to v4](https://sheet.lodev09.com/migration)
- ## Usage
- ```tsx
- 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>
- )
- }
- ```
- ## AI Skills
- Skills are reusable AI capabilities that give your AI coding agent knowledge about TrueSheet. With the right skill loaded, your agent can pick the right patterns, avoid common mistakes, and generate correct code without you having to explain the library every time.
- ```sh
- npx skills add lodev09/react-native-true-sheet
- ```
- This will install the **TrueSheet Usage** skill into your project.
- ## That map is awesome!
- Yes it is! Checkout [`@lugg/maps`](https://github.com/lugg/maps), a universal maps library for React Native that I'm developing at [Lugg](https://lugg.com).
- ## Contributing
- See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.
- ## License
- [MIT](LICENSE)
- ---
- Made with β€οΈ by [@lodev09](http://linkedin.com/in/lodev09/)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If itβs helped, pass it on.