True Sheet

https://sheet.lodev09.com
Admin
True Sheet is a native bottom sheet component for React Native apps built on Fabric architecture...
Tokens:26,854
Snippets:382
Trust Score:7.9
Update:1 month ago
Show doc for...
Tokens:
Raw
### Install Radix UI Dialog

Source: https://sheet.lodev09.com/blog/release-3-11

Install the new web peer dependency required for the web renderer.

```bash
yarn add @radix-ui/react-dialog
```

--------------------------------

### Install True Sheet

Source: https://sheet.lodev09.com/blog/release-3-10

Command to install the 3.10.0 version of the package.

```bash
yarn add @lodev09/react-native-true-sheet@^3.10.0
```

--------------------------------

### Install TrueSheet Web Dependencies

Source: https://sheet.lodev09.com/guides/web

Install the required Radix UI primitives for the web renderer.

```bash
yarn add @radix-ui/react-dialog @radix-ui/react-presence
```

--------------------------------

### Install React Navigation dependency

Source: https://sheet.lodev09.com/guides/navigation

Install the required peer dependency for React Navigation.

```bash
npm install @react-navigation/native
```

--------------------------------

### Setup TrueSheetProvider

Source: https://sheet.lodev09.com/guides/web

Wrap the application with TrueSheetProvider to enable sheet functionality.

```javascript
import { TrueSheetProvider } from '@lodev09/react-native-true-sheet'  
  
const App = () => {  
  return (  
    <TrueSheetProvider>  
      <YourApp />  
    </TrueSheetProvider>  
  )  
}
```

--------------------------------

### Installing True Sheet 3.9

Source: https://sheet.lodev09.com/blog/release-3-9

Install the latest version of the package using yarn.

```bash
yarn add @lodev09/react-native-true-sheet@^3.9.0  
```

--------------------------------

### Install package

Source: https://sheet.lodev09.com/migration

Update the library to version 3.0.0 using yarn or npm.

```shell
yarn add @lodev09/react-native-true-sheet@^3.0.0
```

```shell
npm install @lodev09/react-native-true-sheet@^3.0.0
```

--------------------------------

### Install True Sheet via Yarn

Source: https://sheet.lodev09.com/blog/release-3-0

Use this command to install the package in a standard React Native project.

```bash
yarn add @lodev09/react-native-true-sheet@^3.0.0
```

--------------------------------

### Basic TrueSheet Configuration

Source: https://sheet.lodev09.com/reference/configuration

Example of initializing a TrueSheet component with ref, detents, and background color properties.

```jsx
<TrueSheet  
  ref={sheet}  
  detents={['auto', 0.8, 1]}  
  backgroundColor="#696969"  
  // ...  
>  
  <View />  
</TrueSheet>
```

--------------------------------

### Install True Sheet via Expo

Source: https://sheet.lodev09.com/blog/release-3-0

Use this command to install the package in an Expo-managed project.

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

--------------------------------

### Install True Sheet in Bare React Native

Source: https://sheet.lodev09.com/install

Use these commands to add the dependency and install native iOS pods in a bare React Native project.

```bash
yarn add @lodev09/react-native-true-sheet
```

```bash
cd ios && pod install
```

--------------------------------

### Check Xcode Version

Source: https://sheet.lodev09.com/troubleshooting

Run this command in your terminal to verify the installed Xcode version.

```bash
xcodebuild -version  
```

--------------------------------

### Add AI Coding Skill

Source: https://sheet.lodev09.com/usage

Install the TrueSheet usage skill to provide AI coding agents with library-specific knowledge.

```bash
npx skills add lodev09/react-native-true-sheet
```

--------------------------------

### Jest Configuration

Source: https://sheet.lodev09.com/guides/jest

Update your Jest configuration to include the setup file and ensure the package is transformed correctly.

```json
{
  "jest": {
    "setupFilesAfterEnv": ["<rootDir>/jest.setup.js"],
    "transformIgnorePatterns": [
      "node_modules/(?!(react-native|@react-native|@lodev09/react-native-true-sheet)/)"
    ]
  }
}
```

--------------------------------

### Install True Sheet 3.11

Source: https://sheet.lodev09.com/blog/release-3-11

Update the True Sheet package to version 3.11.0.

```bash
yarn add @lodev09/react-native-true-sheet@^3.11.0
```

--------------------------------

### Implement TrueSheet Lifecycle Events

Source: https://sheet.lodev09.com/reference/events

Example demonstrating the usage of various lifecycle event handlers within a TrueSheet component.

```typescript
const App = () => {  
  const handleDismiss = () => {  
    console.log('Bye bye')  
  }  
  
  const handleOnWillPresent = (e: WillPresentEvent) => {  
    console.log(e.nativeEvent) // { index: 0, position: 123.5, detent: 0.5 }  
    console.log('Sheet is about to be presented')  
  }  
  
  const handleOnDidPresent = (e: DidPresentEvent) => {  
    console.log(e.nativeEvent) // { index: 0, position: 123.5, detent: 0.5 }  
  }  
  
  const handleDetentChange = (e: DetentChangeEvent) => {  
    console.log(e.nativeEvent) // { index: 1, position: 234.5, detent: 0.8 }  
  }  
  
  return (  
    <View>  
      <Button title="Present" onPress={() => sheet.current?.present()} />  
      <TrueSheet  
        ref={sheet}  
        detents={[0.5, 0.8]}  
        onWillPresent={handleOnWillPresent}  
        onDidPresent={handleOnDidPresent}  
        onDetentChange={handleDetentChange}  
        onWillDismiss={handleOnWillDismiss}  
        onDidDismiss={handleOnDidDismiss}  
      >  
        <Button title="Resize" onPress={() => sheet.current?.resize(1)} />  
        <Button title="Dismiss" onPress={() => sheet.current?.dismiss(1)} />  
      </TrueSheet>  
    </View>  
  )  
}  
```

--------------------------------

### Install True Sheet version 3.4.0

Source: https://sheet.lodev09.com/blog/android-stacking

Use this command to install the required version of the True Sheet package for React Native.

```bash
yarn add @lodev09/react-native-true-sheet@^3.4.0
```

--------------------------------

### Present sheet on focus for deep linking

Source: https://sheet.lodev09.com/troubleshooting

Use useFocusEffect to trigger the sheet presentation when a screen gains focus, bypassing issues where initialDetentIndex fails during cold starts on iOS.

```tsx
import { useFocusEffect } from '@react-navigation/native';  
import { useCallback } from 'react';  
  
function HomeScreen() {  
  const sheet = useRef<TrueSheet>(null);  
  const [didPresent, setDidPresent] = useState(false);  
  
  useFocusEffect(  
    useCallback(() => {  
      if (!didPresent) {  
        sheet.current?.present();  
      }  
    }, [didPresent])  
  );  
  
  return (  
    <View>  
      <TrueSheet  
        ref={sheet}  
        initialDetentIndex={0}  
        onDidPresent={() => setDidPresent(true)}  
      >  
        {/* ... */}  
      </TrueSheet>  
    </View>  
  );  
}
```

--------------------------------

### Run application

Source: https://sheet.lodev09.com/migration

Launch the application on iOS and Android simulators or devices.

```shell
npx react-native run-ios
npx react-native run-android
```

--------------------------------

### Presenting a sheet on mount

Source: https://sheet.lodev09.com/guides/onmount

Use the initialDetentIndex prop to specify which detent index the sheet should open to when mounted.

```javascript
const App = () => {  
  return (  
    <TrueSheet  
      detents={['auto', 0.69, 1]}  
      initialDetentIndex={1}  
      initialDetentAnimated  
    >  
      <View />  
    </TrueSheet>  
  )  
}  
```

--------------------------------

### Present Sheets Using Global Static Methods

Source: https://sheet.lodev09.com/blog/release-3-0

Register a sheet with a name and trigger its presentation from anywhere in the application.

```jsx
// Register a named sheet  
<TrueSheet name="my-sheet">  
  {/* content */}  
</TrueSheet>  
  
// Present from anywhere  
TrueSheet.present('my-sheet')  
```

--------------------------------

### Configure Jest Mocks

Source: https://sheet.lodev09.com/guides/jest

Add these mocks to your jest.setup.js file to enable testing for TrueSheet components, navigation, and Reanimated integration.

```javascript
// jest.setup.js  
  
// 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')  
);
```

--------------------------------

### Implement Cross-Platform Overlays

Source: https://sheet.lodev09.com/guides/overlays

Uses Platform.select to switch between FullWindowOverlay for iOS and Modal for Android, ensuring overlays render above the sheet.

```javascript
import { Platform, Modal } from 'react-native'  
import { FullWindowOverlay } from 'react-native-screens'  
  
const Overlay = Platform.select({  
  ios: FullWindowOverlay,  
  default: Modal,  
})  
  
export const App = () => {  
  const [visible, setVisible] = useState(false)  
  
  return (  
    <>  
      <TrueSheet>  
        <Button title="Show Dialog" onPress={() => setVisible(true)} />  
      </TrueSheet>  
  
      <Overlay visible={visible} transparent>  
        <YourDialogContent onClose={() => setVisible(false)} />  
      </Overlay>  
    </>  
  )  
}  
```

--------------------------------

### Reanimated integration for position events

Source: https://sheet.lodev09.com/guides/navigation

Enable worklet-based position events for smooth animations. Requires react-native-reanimated to be installed.

```javascript
// In your navigator  
<Sheet.Screen  
  name="Details"  
  component={DetailsSheet}  
  options={{  
    reanimated: true,  
    positionChangeHandler: (payload) => {  
      'worklet';  
      // Access payload.position, payload.detentIndex, etc.  
      console.log(payload.position);  
    },  
  }}  
/>  
```

--------------------------------

### Configure Native Header and Footer

Source: https://sheet.lodev09.com/blog/release-3-0

Add fixed header and footer components that remain stationary while the main content scrolls.

```jsx
<TrueSheet  
  header={<MyHeader />}  
  footer={<MyFooter />}  
>  
  <FlatList data={items} renderItem={renderItem} />  
</TrueSheet>  
```

--------------------------------

### Configure dimming by detent index

Source: https://sheet.lodev09.com/guides/dimming

Use dimmedDetentIndex to specify the detent index at which the background starts dimming. This property is ignored if dimmed is set to false.

```typescript
export const App = () => {  
  return (  
    <TrueSheet  
      detents={['auto', 0.69, 1]}  
      dimmedDetentIndex={1} // Dim will start at 69% ✅  
    >  
      <View />  
    </TrueSheet>  
  )  
}  
```

--------------------------------

### Implement Footer with Auto Detent

Source: https://sheet.lodev09.com/migration

Use useSafeAreaInsets to ensure the footer background extends into the bottom safe area while keeping content visible.

```javascript
import { Platform } from 'react-native';  
import { useSafeAreaInsets } from 'react-native-safe-area-context';  
  
const isIPad = Platform.OS === 'ios' && Platform.isPad;  
  
const MyFooter = () => {  
  const insets = useSafeAreaInsets();  
  const bottomInset = isIPad ? 0 : insets.bottom;  
  
  return (  
    <View style={{ paddingBottom: bottomInset, backgroundColor: '#333' }}>  
      <View style={{ height: 60, justifyContent: 'center', alignItems: 'center' }}>  
        <Text>Footer Content</Text>  
      </View>  
    </View>  
  );  
};  
  
// Usage  
<TrueSheet detents={['auto']} footer={<MyFooter />}>  
  {/* content */}
</TrueSheet>
```

--------------------------------

### Clean Android build

Source: https://sheet.lodev09.com/migration

Run the Gradle clean task to ensure a fresh build environment.

```shell
cd android
./gradlew clean
cd ..
```

--------------------------------

### Implement a basic header with TrueSheet

Source: https://sheet.lodev09.com/guides/header

Use the header prop to render a fixed view above scrollable content. The layout automatically accounts for the header height.

```javascript
const App = () => {  
  return (  
    <TrueSheet  
      ref={sheet}  
      header={  
        <View style={styles.header}>  
          <Text>My Header</Text>  
        </View>  
      }  
    >  
      <ScrollView>  
        <View>{/* Your scrollable content */}</View>  
      </ScrollView>  
    </TrueSheet>  
  )  
}  
  
const styles = StyleSheet.create({  
  header: {  
    padding: 16,  
    borderBottomWidth: 1,  
    borderBottomColor: '#eee',  
  },  
})
```

--------------------------------

### Opt-out of Precompiled Modules for Specific Packages

Source: https://sheet.lodev09.com/troubleshooting

Configure package.json to build only specific libraries from source, avoiding the need to disable precompilation for the entire project.

```json
{
  "expo": {
    "autolinking": {
      "ios": { "buildFromSource": ["react-native-screens"] }
    }
  }
}
```

--------------------------------

### Initialize Sheet Navigator

Source: https://sheet.lodev09.com/blog/sheet-navigator

Configure the navigator within a NavigationContainer to define base screens and sheet screens.

```javascript
import { NavigationContainer } from '@react-navigation/native';  
import { createTrueSheetNavigator } from '@lodev09/react-native-true-sheet/navigation';  
  
const Sheet = createTrueSheetNavigator();  
  
function App() {  
  return (  
    <NavigationContainer>  
      <Sheet.Navigator>  
        <Sheet.Screen name="Home" component={HomeScreen} />  
        <Sheet.Screen  
          name="Details"  
          component={DetailsSheet}  
          options={{ detents: ['auto', 1], cornerRadius: 16 }}  
        />  
      </Sheet.Navigator>  
    </NavigationContainer>  
  );  
}  
```

--------------------------------

### Import Sheet Navigator components

Source: https://sheet.lodev09.com/blog/sheet-navigator

Import the necessary navigator and hook from the navigation subpath to begin using Sheet Navigator.

```typescript
import {  
  createTrueSheetNavigator,  
  useTrueSheetNavigation,  
} from '@lodev09/react-native-true-sheet/navigation';
```

--------------------------------

### Resizing and navigating from a sheet

Source: https://sheet.lodev09.com/guides/navigation

Use the useTrueSheetNavigation hook to resize the sheet or navigate back.

```javascript
function DetailsSheet() {  
  const navigation = useTrueSheetNavigation();  
  
  return (  
    <View>  
      <Button title="Expand" onPress={() => navigation.resize(1)} />  
      <Button title="Close" onPress={() => navigation.goBack()} />  
    </View>  
  );  
}  
```

--------------------------------

### Navigate to Sheets

Source: https://sheet.lodev09.com/blog/sheet-navigator

Trigger sheet presentation from any screen within the navigation stack.

```jsx
// From anywhere in RootStack  
navigation.navigate('QuickActions');  
```

--------------------------------

### Rebuild Expo app after configuration changes

Source: https://sheet.lodev09.com/guides/liquid-glass

Run these commands to apply global configuration changes to your iOS build.

```bash
npx expo prebuild --clean  
npx expo run:ios  
```

--------------------------------

### Clean iOS dependencies

Source: https://sheet.lodev09.com/migration

Remove existing Pods and reinstall dependencies for iOS.

```shell
cd ios
rm -rf Pods Podfile.lock build
pod install
cd ..
```

--------------------------------

### Test Static Methods

Source: https://sheet.lodev09.com/guides/jest

Verify that static methods like present and dismiss are called with the expected arguments.

```javascript
import { TrueSheet } from '@lodev09/react-native-true-sheet';  
  
it('should present sheet', async () => {  
  await TrueSheet.present('my-sheet', 0);  
  
  expect(TrueSheet.present).toHaveBeenCalledWith('my-sheet', 0);  
});  
  
it('should dismiss sheet', async () => {  
  await TrueSheet.dismiss('my-sheet');  
  
  expect(TrueSheet.dismiss).toHaveBeenCalledWith('my-sheet');  
});
```

--------------------------------

### Navigate to a Sheet

Source: https://sheet.lodev09.com/blog/sheet-navigator

Trigger a sheet presentation using the standard navigation.navigate method.

```javascript
navigation.navigate('Details', { itemId: 123 });  
```

--------------------------------

### present

Source: https://sheet.lodev09.com/reference/methods

Presents the sheet. Can be called via component ref or globally by name.

```APIDOC
## present(index?: number, animated?: boolean)

### Description
Present the sheet. Optionally accepts a detent index and an animated flag.

### Parameters
- **index** (number) - Optional - The detent index to present at. Default: 0.
- **animated** (boolean) - Optional - Whether to animate the presentation. Default: true.

### Usage
```javascript
// Component method
await sheet.current?.present(0, true);

// Global method
await TrueSheet.present('my-sheet', 0, true);
```
```

--------------------------------

### Import TrueSheet

Source: https://sheet.lodev09.com/usage

Import the TrueSheet component from the library package.

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

--------------------------------

### Present a sheet globally

Source: https://sheet.lodev09.com/blog/release-0-10

Use the static present method to trigger a sheet by its registered name from any component.

```javascript
import { TrueSheet } from '@lodev09/react-native-true-sheet'  
  
const SomeComponent = () => {  
  const presentMySheet = () => {  
    TrueSheet.present('my-sheet') // 🎉  
  }  
  
  return (  
    <Button onPress={presentMySheet} title="Present My Sheet" />  
  )  
}  
```

--------------------------------

### Presenting Stacked Sheets

Source: https://sheet.lodev09.com/guides/stacking

Present a new sheet while another is already visible to trigger automatic stacking. The previous sheet is hidden until the new one is dismissed.

```javascript
const presentSheet2 = async () => {  
  await sheet2.current?.present() // Sheet 2 will present, Sheet 1 will be hidden  
}  
  
return (  
  <>
    <TrueSheet ref={sheet1}>  
      <Button onPress={presentSheet2} title="Present Sheet 2" />  
      <View />  
    </TrueSheet>  
    <TrueSheet ref={sheet2}>  
      <View />  
    </TrueSheet>  
  </>
)  
```

--------------------------------

### Present Sheet Imperatively

Source: https://sheet.lodev09.com/reference/methods

Use the present method to display the sheet, optionally specifying a detent index and animation state.

```typescript
await sheet.current?.present()  
  
// Present without animation  
await sheet.current?.present(0, false)
```

--------------------------------

### Configure Screen Listeners on Navigator

Source: https://sheet.lodev09.com/guides/navigation

Apply listeners globally to the navigator using the screenListeners prop.

```jsx
<Sheet.Navigator  
  screenListeners={{  
    sheetDidPresent: (e) => console.log('Presented:', e.data.index),  
    sheetDidDismiss: () => console.log('Dismissed'),  
  }}  
>  

```

--------------------------------

### Configure Sheet Screen Options

Source: https://sheet.lodev09.com/blog/sheet-navigator

Apply TrueSheet props declaratively within a Sheet.Screen component.

```jsx
<Sheet.Screen  
  name="Settings"  
  component={SettingsSheet}  
  options={{  
    detents: [0.5, 1],  
    cornerRadius: 20,  
    grabber: true,  
    dimmedDetentIndex: 1,  
    backgroundColor: '#1a1a1a',  
  }}  
/>  
```

--------------------------------

### createTrueSheetNavigator

Source: https://sheet.lodev09.com/guides/navigation

Creates a custom navigator for React Navigation to handle sheet-based screen presentation.

```APIDOC
## createTrueSheetNavigator

### Description
Creates a navigator instance that allows defining screens as sheets within a React Navigation container.

### Usage
```javascript
const Sheet = createTrueSheetNavigator();

<Sheet.Navigator>
  <Sheet.Screen name="Main" component={MainScreen} />
  <Sheet.Screen name="Details" component={DetailsSheet} />
</Sheet.Navigator>
```
```

--------------------------------

### Register a sheet with a name

Source: https://sheet.lodev09.com/blog/release-0-10

Assign a unique name to a TrueSheet instance to enable global presentation.

```javascript
const App = () => {  
  return (  
    <TrueSheet name="my-sheet">  
      <View />  
    </TrueSheet>  
  )  
}  
```

--------------------------------

### TrueSheet.present(name)

Source: https://sheet.lodev09.com/guides/global-methods

Presents a sheet identified by the provided name globally.

```APIDOC
## TrueSheet.present(name)

### Description
Triggers the presentation of a sheet that has been registered with the specified name.

### Parameters
- **name** (string) - Required - The unique name assigned to the TrueSheet component instance.
```

--------------------------------

### Collapse sheet to header using peek

Source: https://sheet.lodev09.com/guides/header

Configure the sheet to collapse to the header height by setting the peek detent.

```javascript
const App = () => {  
  return (  
    <TrueSheet  
      detents={['peek', 0.9]}  
      initialDetentIndex={0}  
      header={<BookingSummary />}  
      footer={<SheetActions />}  
      scrollable  
    >  
      <BookingDetails />  
    </TrueSheet>  
  )  
}
```

--------------------------------

### BlurOptions

Source: https://sheet.lodev09.com/reference/types

Configuration object for customizing the background blur effect of the TrueSheet.

```APIDOC
## BlurOptions

### Description
Options for customizing the blur effect. Only applies when `backgroundBlur` is set.

### Properties
- **intensity** (number) - The intensity of the blur effect (0-100). Default: system default.
- **interaction** (boolean) - Enables or disables user interaction on the blur view. Default: true.
```

--------------------------------

### Define a Footer Component

Source: https://sheet.lodev09.com/guides/footer

Create a functional component to serve as the footer content.

```javascript
const SomeFooter = () => {  
  return (  
    <View>  
      <Text>My Foot-er is Awesome.</Text>  
    </View>  
  )  
}  
```

--------------------------------

### Define peek height with TrueSheetPeek

Source: https://sheet.lodev09.com/guides/peeking

Wrap specific content with TrueSheetPeek to include it in the collapsed peek height calculation.

```jsx
import { TrueSheet, TrueSheetPeek } from '@lodev09/react-native-true-sheet'  
  
const App = () => {  
  return (  
    <TrueSheet detents={['peek', 0.9]} initialDetentIndex={0}>  
      <TrueSheetPeek>  
        <BookingSummary />  
      </TrueSheetPeek>  
      <BookingDetails />  
    </TrueSheet>  
  )  
}  
```

--------------------------------

### Wrap Existing Navigation

Source: https://sheet.lodev09.com/blog/sheet-navigator

Integrate TrueSheet into an existing navigation structure by wrapping it with a Sheet Navigator.

```jsx
const Stack = createNativeStackNavigator();  
const Sheet = createTrueSheetNavigator();  
  
function RootStack() {  
  return (  
    <Stack.Navigator>  
      <Stack.Screen name="Home" component={HomeScreen} />  
      <Stack.Screen name="Profile" component={ProfileScreen} />  
    </Stack.Navigator>  
  );  
}  
  
function App() {  
  return (  
    <NavigationContainer>  
      <Sheet.Navigator>  
        <Sheet.Screen name="Root" component={RootStack} />  
        <Sheet.Screen name="QuickActions" component={QuickActionsSheet} />  
        <Sheet.Screen name="Share" component={ShareSheet} />  
      </Sheet.Navigator>  
    </NavigationContainer>  
  );  
}  
```

--------------------------------

### Implement TrueSheet with Expo Router

Source: https://sheet.lodev09.com/guides/navigation

Use withLayoutContext to wrap the TrueSheet navigator for use in Expo Router layouts.

```tsx
// app/_layout.tsx  
import { withLayoutContext } from 'expo-router';  
import {  
  createTrueSheetNavigator,  
  type TrueSheetNavigationEventMap,  
  type TrueSheetNavigationOptions,  
  type TrueSheetNavigationState,  
} from '@lodev09/react-native-true-sheet/navigation';  
  
type ParamListBase = Record<string, object | undefined>;  
  
const { Navigator } = createTrueSheetNavigator();  
  
const Sheet = withLayoutContext<  
  TrueSheetNavigationOptions,  
  typeof Navigator,  
  TrueSheetNavigationState<ParamListBase>,  
  TrueSheetNavigationEventMap  
>(Navigator);  
  
export default function SheetLayout() {  
  return (  
    <Sheet>  
      <Sheet.Screen name="index" />  
      <Sheet.Screen  
        name="details"  
        options={{  
          detents: ['auto', 1],  
          cornerRadius: 16,  
        }}  
      />  
    </Sheet>  
  );  
}  

```

--------------------------------

### Renaming maxHeight to maxContentHeight

Source: https://sheet.lodev09.com/blog/release-3-9

Update existing code to use the new maxContentHeight prop for consistency.

```diff
- <TrueSheet maxHeight={600}>  
+ <TrueSheet maxContentHeight={600}>  
```

--------------------------------

### Configure EAS Build Image

Source: https://sheet.lodev09.com/troubleshooting

Set the iOS build image to 'latest' in eas.json to ensure compatibility with Xcode 26.1+.

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

--------------------------------

### Basic TrueSheet Navigator usage

Source: https://sheet.lodev09.com/guides/navigation

Define a basic navigator where the first screen is the base content and subsequent screens are presented as sheets.

```javascript
import { NavigationContainer } from '@react-navigation/native';  
import {  
  createTrueSheetNavigator,  
  useTrueSheetNavigation,  
} from '@lodev09/react-native-true-sheet/navigation';  
  
const Sheet = createTrueSheetNavigator();  
  
function App() {  
  return (  
    <NavigationContainer>  
      <Sheet.Navigator>  
        {/* Base screen (first screen is the default) */}  
        <Sheet.Screen name="Main" component={MainScreen} />  
        {/* Sheet screens */}  
        <Sheet.Screen  
          name="Details"  
          component={DetailsSheet}  
          options={{ detents: ['auto', 1], cornerRadius: 16 }}  
        />  
      </Sheet.Navigator>  
    </NavigationContainer>  
  );  
}  
```

--------------------------------

### Implement Reanimated v4 Integration

Source: https://sheet.lodev09.com/migration

Utilize the ReanimatedTrueSheet components and hooks to track sheet position and create animated UI elements.

```typescript
import {  
  ReanimatedTrueSheetProvider,  
  ReanimatedTrueSheet,  
  useReanimatedTrueSheet,  
} from '@lodev09/react-native-true-sheet/reanimated'  
import Animated, { useAnimatedStyle, interpolate, Extrapolation } from 'react-native-reanimated'  
  
// 1. Wrap your app with the provider  
const App = () => (  
  <ReanimatedTrueSheetProvider>  
    <YourApp />  
  </ReanimatedTrueSheetProvider>  
)  
  
// 2. Use ReanimatedTrueSheet instead of TrueSheet  
const MySheet = () => (  
  <ReanimatedTrueSheet detents={[0.3, 0.6, 1]} initialDetentIndex={1}>  
    <Text>Sheet Content</Text>  
  </ReanimatedTrueSheet>  
)  
  
// 3. Access the sheet's position for custom animations  
const MyAnimatedComponent = () => {  
  const { animatedPosition, animatedIndex } = useReanimatedTrueSheet()  
  
  const positionStyle = useAnimatedStyle(() => ({  
    transform: [{ translateY: -animatedPosition.value }],  
  }))  
  
  // Example: Fade in as sheet expands from index 0 to 1  
  const opacityStyle = useAnimatedStyle(() => ({  
    opacity: interpolate(animatedIndex.value, [0, 1], [0, 1], Extrapolation.CLAMP)  
  }))  
  
  return (  
    <Animated.View style={[opacityStyle, positionStyle]}>  
      <Text>This moves with the sheet</Text>  
    </Animated.View>  
  )  
}
```

--------------------------------

### Define Expo Router File Structure

Source: https://sheet.lodev09.com/guides/navigation

Standard file layout for integrating TrueSheet with Expo Router.

```text
app/  
├── _layout.tsx          # TrueSheet navigator  
├── index.tsx            # Base content  
└── details.tsx          # Sheet screen  

```

--------------------------------

### Basic TextInput Implementation

Source: https://sheet.lodev09.com/guides/keyboard

Place TextInput components directly inside a TrueSheet to enable automatic keyboard avoidance.

```javascript
const App = () => {  
  return (  
    <TrueSheet ref={sheet} detents={['auto']}>  
      <View style={{ padding: 16 }}>  
        <TextInput  
          placeholder="Type something..."  
          style={{ borderWidth: 1, borderColor: '#ccc', padding: 12, borderRadius: 8 }}  
        />  
      </View>  
    </TrueSheet>  
  )  
}  
```

--------------------------------

### Define TrueSheet with Ref

Source: https://sheet.lodev09.com/reference/methods

Initialize a TrueSheet component with a ref to enable imperative method access.

```typescript
const sheet = useRef<TrueSheet>(null)  
  
return (  
  <TrueSheet ref={sheet} detents={['auto', 0.8]}>  
    <View />  
  </TrueSheet>  
)
```

--------------------------------

### Resize to peek programmatically

Source: https://sheet.lodev09.com/guides/peeking

Use the resize method on the sheet reference to collapse the sheet back to the peek detent.

```javascript
sheet.current?.resize(0) // collapse back to peek  
```

--------------------------------

### Implement and Control TrueSheet

Source: https://sheet.lodev09.com/usage

Define the component with a ref to programmatically trigger presentation and dismissal actions.

```typescript
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]}  
        cornerRadius={24}  
      >  
        <Button onPress={dismiss} title="Dismiss" />  
      </TrueSheet>  
    </View>  
  )  
}
```

--------------------------------

### Configure GrabberOptions for TrueSheet

Source: https://sheet.lodev09.com/reference/types

Customize the dimensions, color, and adaptive behavior of the drag handle using the grabberOptions prop.

```jsx
<TrueSheet  
  grabber  
  grabberOptions={{  
    width: 48,  
    height: 6,  
    topMargin: 10,  
    cornerRadius: 3,  
    color: '#FF0000',  
    adaptive: false,  
  }}  
>  
  <View />  
</TrueSheet>
```

--------------------------------

### Configure FooterOptions for TrueSheet

Source: https://sheet.lodev09.com/reference/types

Use keyboardOffset to adjust the footer position relative to the keyboard, typically using safe area insets.

```jsx
<TrueSheet  
  footer={<Footer />}  
  footerOptions={{  
    keyboardOffset: -insets.bottom,  
  }}  
>  
  {/* ... */}  
</TrueSheet>
```

--------------------------------

### addListener

Source: https://sheet.lodev09.com/guides/navigation

Registers an event listener within a screen component using the navigation object.

```APIDOC
## addListener

### Description
Registers a listener for specific sheet events within a functional component using the useTrueSheetNavigation hook.

### Usage
const unsubscribe = navigation.addListener('sheetDidPresent', (e) => { console.log('Presented:', e.data.index); });
```

--------------------------------

### Docking a sheet to the side

Source: https://sheet.lodev09.com/guides/side-sheets

Set the anchor prop to 'left' or 'right' to position the sheet. Combine with maxContentWidth to manage the sheet's width.

```javascript
export const App = () => {  
  return (  
    <TrueSheet  
      detents={['auto', 1]}  
      anchor="left"  
      maxContentWidth={400}  
    >  
      <View />  
    </TrueSheet>  
  )  
}  
```

--------------------------------

### Enable Edge-to-Edge in Gradle

Source: https://sheet.lodev09.com/guides/edge-to-edge

Add this property to your android/gradle.properties file to enable edge-to-edge support.

```properties
edgeToEdgeEnabled=true
```

--------------------------------

### Wrap content with GestureHandlerRootView for Android

Source: https://sheet.lodev09.com/troubleshooting

Use this wrapper to ensure gesture recognition works correctly within the sheet on Android. Apply flexGrow: 1 to prevent layout conflicts.

```jsx
import { GestureHandlerRootView } from 'react-native-gesture-handler'  
  
<TrueSheet>  
  <GestureHandlerRootView style={{ flexGrow: 1 }}>  
    {/* Your content with gestures */}  
  </GestureHandlerRootView>  
</TrueSheet>
```

--------------------------------

### useTrueSheetNavigation

Source: https://sheet.lodev09.com/guides/navigation

Hook to access navigation methods for controlling sheet behavior from within a screen.

```APIDOC
## useTrueSheetNavigation

### Description
Provides access to sheet-specific navigation methods such as resizing or closing the sheet.

### Methods
- **resize(index: number)**: Resizes the sheet to the specified detent index.
- **goBack()**: Closes the current sheet.
- **setOptions(options: object)**: Dynamically updates sheet options like header or footer.
- **addListener(event: string, callback: function)**: Adds listeners for sheet events like 'sheetDetentChange'.
```

--------------------------------

### screenListeners

Source: https://sheet.lodev09.com/guides/navigation

Configures event listeners directly on the Sheet Navigator to track sheet lifecycle events.

```APIDOC
## screenListeners

### Description
Allows subscribing to sheet lifecycle events such as presentation and dismissal directly on the navigator component.

### Usage
<Sheet.Navigator screenListeners={{ sheetDidPresent: (e) => console.log('Presented:', e.data.index), sheetDidDismiss: () => console.log('Dismissed'), }} >
```

--------------------------------

### AccessibilityOptions Configuration

Source: https://sheet.lodev09.com/reference/types

Configuration properties for customizing accessibility strings in TrueSheet.

```APIDOC
## AccessibilityOptions

### Description
Options for customizing (e.g. localizing) the accessibility strings announced by screen readers.

### Properties
- **grabberLabel** (string) - The accessibility label of the grabber. Default: iOS: 'Sheet Grabber', Android: 'Drag handle'
- **grabberHint** (string) - The accessibility hint of the grabber. iOS only. Default: 'Double-tap to expand. Swipe up or down to resize the sheet'
- **expandedValue** (string) - The value announced when the sheet is at the last detent. Default: 'Expanded'
- **collapsedValue** (string) - The value announced when the sheet is at the first detent. Default: 'Collapsed'
- **detentValue** (string) - The value announced at intermediate detents. Supports {index} and {count} placeholders. Default: 'Detent {index} of {count}'
- **expandActionLabel** (string) - The label of the expand accessibility action. Android only. Default: 'Expand'
- **collapseActionLabel** (string) - The label of the collapse accessibility action. Android only. Default: 'Collapse'
- **paneTitle** (string) - The title announced when the sheet appears. Sets the accessibility pane title on Android and the hidden dialog title on Web. Default: Android: 'Bottom sheet', Web: 'Sheet'

### Usage Example
<TrueSheet
  accessibilityOptions={{
    grabberLabel: 'Poignée de déplacement',
    expandedValue: 'Développé',
    collapsedValue: 'Réduit',
    detentValue: 'Position {index} sur {count}',
  }}
>
  <View />
</TrueSheet>
```

--------------------------------

### Configure Detached Mode

Source: https://sheet.lodev09.com/guides/web

Render the sheet as a floating card using the detached prop and adjust spacing with detachedOffset.

```javascript
<TrueSheet detached detachedOffset={24} detents={[0.5]}>  
  {/* Content */}  
</TrueSheet>
```

--------------------------------

### Implement the peek detent

Source: https://sheet.lodev09.com/guides/peeking

Add 'peek' to the detents array to automatically calculate sheet height based on header and footer components.

```jsx
const App = () => {  
  return (  
    <TrueSheet  
      detents={['peek', 0.9]}  
      initialDetentIndex={0}  
      header={<BookingSummary />}  
      footer={<SheetActions />}  
      scrollable  
    >  
      <BookingDetails />  
    </TrueSheet>  
  )  
}  
```

--------------------------------

### Implement custom dynamic dimming

Source: https://sheet.lodev09.com/guides/dimming

Use ReanimatedTrueSheet and animatedPosition to control dimming opacity dynamically based on the sheet's position.

```typescript
import { ReanimatedTrueSheet, ReanimatedTrueSheetProvider, useReanimatedTrueSheet } from '@lodev09/react-native-true-sheet/reanimated'  
import Animated, { useAnimatedStyle } from 'react-native-reanimated'  
import { StyleSheet } from 'react-native'  
  
export const App = () => {  
  return (  
    <ReanimatedTrueSheetProvider>  
      <View style={styles.container}>  
        <CustomBackdrop />  
        <Sheet />  
      </View>  
    </ReanimatedTrueSheetProvider>  
  )  
}  
  
const CustomBackdrop = () => {  
  const { animatedPosition } = useReanimatedTrueSheet()  
  
  const backdropStyle = useAnimatedStyle(() => ({
    opacity: animatedPosition.value * 0.5, // Adjust multiplier for desired alpha  
  }))  
  
  return <Animated.View style={[StyleSheet.absoluteFill, styles.backdrop, backdropStyle]} />  
}  
  
const Sheet = () => {  
  return (  
    <ReanimatedTrueSheet  
      detents={[0.25, 0.5, 1]}  
      dimmed={false}  
    >  
      <View />  
    </ReanimatedTrueSheet>  
  )  
}  
  
const styles = StyleSheet.create({  
  container: {  
    flex: 1,  
  },  
  backdrop: {  
    backgroundColor: 'black',  
  },  
})  
```

--------------------------------

### Test Component Rendering

Source: https://sheet.lodev09.com/guides/jest

Ensure that TrueSheet renders its children correctly by checking for expected content.

```javascript
it('should render sheet content', () => {  
  const { getByText } = render(  
    <TrueSheet name="test" initialDetentIndex={0}>  
      <Text>Sheet Content</Text>  
    </TrueSheet>  
  );  
  
  expect(getByText('Sheet Content')).toBeDefined();  
});
```

--------------------------------

### Integrate with Reanimated v4

Source: https://sheet.lodev09.com/blog/release-3-0

Utilize ReanimatedTrueSheetProvider and hooks to create complex animations tied to the sheet's expansion state.

```jsx
import {  
  ReanimatedTrueSheetProvider,  
  ReanimatedTrueSheet,  
  useReanimatedTrueSheet,  
} from '@lodev09/react-native-true-sheet/reanimated'  
import Animated, { useAnimatedStyle, interpolate, Extrapolation } from 'react-native-reanimated'  
  
const App = () => (  
  <ReanimatedTrueSheetProvider>  
    <MySheet />  
  </ReanimatedTrueSheetProvider>  
)  
  
const MySheet = () => (  
  <ReanimatedTrueSheet detents={[0.3, 0.6, 1]}>  
    <AnimatedContent />  
  </ReanimatedTrueSheet>  
)  
  
const AnimatedContent = () => {  
  const { animatedIndex } = useReanimatedTrueSheet()  
  
  // Fade in as sheet expands from index 0 to 1  
  const animatedStyle = useAnimatedStyle(() => ({  
    opacity: interpolate(animatedIndex.value, [0, 1], [0, 1], Extrapolation.CLAMP)  
  }))  
  
  return (  
    <Animated.View style={animatedStyle}>  
      <Text>I fade in as the sheet expands!</Text>  
    </Animated.View>  
  )  
}  
```

--------------------------------

### Migrate Grabber Configuration

Source: https://sheet.lodev09.com/migration

Replace the removed grabberProps with the boolean grabber prop to toggle the native Material Design 3 grabber.

```jsx
// ❌ v2  
<TrueSheet grabberProps={{ color: 'red', width: 40 }}>  
  {/* ... */}  
</TrueSheet>  
  
// ✅ v3 - grabber is native, use boolean to show/hide  
<TrueSheet grabber={true}>  
  {/* ... */}  
</TrueSheet>
```

--------------------------------

### Manage sheet visibility on web

Source: https://sheet.lodev09.com/guides/navigation

Use useFocusEffect to manually present and dismiss the sheet when the screen gains or loses focus, as automatic detection is not supported on web.

```typescript
import { useFocusEffect } from '@react-navigation/native';  
  
function DetailsSheet() {  
  const sheet = useRef<TrueSheet>(null);  
  
  useFocusEffect(  
    useCallback(() => {  
      sheet.current?.present();  
  
      return () => {  
        sheet.current?.dismiss();  
      };  
    }, [])  
  );  
  
  return <TrueSheet ref={sheet}>{/* ... */}</TrueSheet>;  
}  
```

--------------------------------

### Configure background blur and blur options

Source: https://sheet.lodev09.com/reference/configuration

Apply a blur effect to the sheet background and customize its intensity and interaction behavior. This configuration is specific to iOS.

```jsx
<TrueSheet  
  backgroundBlur="dark"  
  blurOptions={{
    intensity: 80,  
    interaction: false,  
  }}  
>  
  <View />  
</TrueSheet>
```

--------------------------------

### Migrate backgroundColor Default Value

Source: https://sheet.lodev09.com/migration

The backgroundColor prop now defaults to the system default instead of white. Explicitly set it to 'white' if the previous behavior is required.

```javascript
// ❌ v2 - backgroundColor defaults to white  
<TrueSheet />  
  
// ✅ v3 - backgroundColor uses system default (transparent on iOS)  
// If you want white background, explicitly set it:  
<TrueSheet backgroundColor="white" />
```

--------------------------------

### Add a search input to the header

Source: https://sheet.lodev09.com/guides/header

Integrate a TextInput within the header prop for search functionality when using lists.

```javascript
const App = () => {  
  return (  
    <TrueSheet  
      ref={sheet}  
      header={  
        <View style={styles.header}>  
          <TextInput placeholder="Search..." style={styles.input} />  
        </View>  
      }  
    >  
      <FlatList  
        data={items}  
        renderItem={({ item }) => <ItemRow item={item} />}  
      />  
    </TrueSheet>  
  )  
}
```

--------------------------------

### ScrollableOptions

Source: https://sheet.lodev09.com/reference/types

Configuration object for customizing scrollable behavior within the TrueSheet.

```APIDOC
## ScrollableOptions

### Description
Options for customizing scrollable behavior. Only applies when `scrollable` is `true`.

### Properties
- **scrollingExpandsSheet** (boolean) - When `false`, scrolling the content does not expand the sheet to the next detent. Default: true.
- **keyboardScrollOffset** (number) - Additional offset when scrolling to a focused input above the keyboard. Default: 0.
- **topScrollEdgeEffect** (ScrollEdgeEffect) - The scroll edge effect applied to the top edge of the scroll view and header. Default: 'hidden'.
- **bottomScrollEdgeEffect** (ScrollEdgeEffect) - The scroll edge effect applied to the bottom edge of the scroll view and footer. Default: 'hidden'.
```

--------------------------------

### Configure iPad Presentation Mode

Source: https://sheet.lodev09.com/migration

Use the presentation prop to toggle between page and form sheet styles on iPad.

```jsx
<TrueSheet presentation="page" />
```

--------------------------------

### Test Reanimated Integration

Source: https://sheet.lodev09.com/guides/jest

Verify that Reanimated shared values are correctly mocked when using the ReanimatedTrueSheetProvider.

```javascript
import {  
  useReanimatedTrueSheet,  
  ReanimatedTrueSheetProvider,  
} from '@lodev09/react-native-true-sheet/reanimated';  
  
it('should return mocked shared values', () => {  
  const { result } = renderHook(() => useReanimatedTrueSheet(), {  
    wrapper: ReanimatedTrueSheetProvider,  
  });  
  
  expect(result.current.animatedPosition.value).toBe(0);  
  expect(result.current.animatedIndex.value).toBe(-1);  
});
```

--------------------------------

### FooterOptions

Source: https://sheet.lodev09.com/reference/types

Configuration options for customizing footer behavior within the TrueSheet component.

```APIDOC
## FooterOptions

### Description
Options for customizing footer behavior in the TrueSheet component.

### Properties
- **keyboardOffset** (number) - Optional - Adjusts how far the footer rises when the keyboard opens. Positive values raise it higher; pass -insets.bottom to tuck its safe-area padding behind the keyboard instead of leaving a gap. Default: 0
```

--------------------------------

### Wrapping an existing Stack Navigator

Source: https://sheet.lodev09.com/guides/navigation

Wrap a root navigator within the Sheet Navigator to present sheets from anywhere in the application.

```javascript
const Stack = createNativeStackNavigator();  
const Sheet = createTrueSheetNavigator();  
  
function RootStack() {  
  return (  
    <Stack.Navigator>  
      <Stack.Screen name="Home" component={HomeScreen} />  
      <Stack.Screen name="Profile" component={ProfileScreen} />  
    </Stack.Navigator>  
  );  
}  
  
function App() {  
  return (  
    <NavigationContainer>  
      <Sheet.Navigator>  
        <Sheet.Screen name="Root" component={RootStack} />  
        <Sheet.Screen  
          name="Details"  
          component={DetailsSheet}  
          options={{ detents: ['auto', 1], cornerRadius: 16 }}  
        />  
      </Sheet.Navigator>  
    </NavigationContainer>  
  );  
}  
```

--------------------------------

### Dynamic header and footer updates

Source: https://sheet.lodev09.com/guides/navigation

Update the sheet header and footer dynamically using navigation.setOptions and sheet events.

```javascript
function DetailsSheet() {  
  const navigation = useTrueSheetNavigation();  
  const [detentIndex, setDetentIndex] = useState(0);  
  
  useEffect(() => {  
    const unsubscribe = navigation.addListener('sheetDetentChange', (e) => {  
      setDetentIndex(e.data.index);  
    });  
    return unsubscribe;  
  }, [navigation]);  
  
  useEffect(() => {  
    navigation.setOptions({  
      footer: (  
        <View style={{ padding: 16 }}>  
          {detentIndex > 0 && <Button title="Collapse" onPress={() => navigation.resize(0)} />}  
          <Button title="Close" onPress={() => navigation.goBack()} />  
        </View>  
      ),  
    });  
  }, [navigation, detentIndex]);  
  
  return <View>{/* ... */}</View>;  
}  
```

--------------------------------

### Global Dismiss All

Source: https://sheet.lodev09.com/reference/methods

Dismiss all sheets within the current presentation context.

```typescript
await TrueSheet.dismissAll()  
  
// Dismiss all without animation  
await TrueSheet.dismissAll(false)
```

--------------------------------

### Docking a Side Sheet

Source: https://sheet.lodev09.com/blog/release-3-9

Use the anchor prop to dock the sheet to the left or right edge, suitable for tablet layouts.

```jsx
<TrueSheet  
  anchor="left"  
  maxContentWidth={600}  
  detents={['auto', 1]}  
>  
  <View />  
</TrueSheet>  
```

--------------------------------

### Programmatic Sheet Resizing

Source: https://sheet.lodev09.com/blog/sheet-navigator

Use the useTrueSheetNavigation hook to trigger resize actions from within a sheet component.

```jsx
import { useTrueSheetNavigation } from '@lodev09/react-native-true-sheet/navigation';  
  
function DetailsSheet() {  
  const navigation = useTrueSheetNavigation();  
  
  return (  
    <View>  
      <Button title="Expand" onPress={() => navigation.resize(1)} />  
      <Button title="Collapse" onPress={() => navigation.resize(0)} />  
    </View>  
  );  
}  
```

--------------------------------

### Expo Router Integration

Source: https://sheet.lodev09.com/blog/sheet-navigator

Use withLayoutContext to integrate Sheet Navigator with Expo Router layouts and route-based options.

```tsx
// app/_layout.tsx  
import { withLayoutContext } from 'expo-router';  
import { createTrueSheetNavigator } from '@lodev09/react-native-true-sheet/navigation';  
  
const { Navigator } = createTrueSheetNavigator();  
export default withLayoutContext(Navigator);  
```

```tsx
// app/details.tsx  
export const unstable_settings = {  
  options: { detents: ['auto', 1], cornerRadius: 16 },  
};  
  
export default function DetailsSheet() {  
  // Sheet content  
}  
```
Tokens:
Raw