`react-doctor/rn-bottom-sheet-use-integrated-scrollable`

React Native scrollable inside a Bottom Sheet

Category: Bugs
Severity: warn
Source: oxlint-plugin-react-doctor
Framework: react-native
Enabled when: react-native
Tags: react-native
Default: Enabled

Validate the diagnostic

Confirm the reported code matches this rule before you edit it.

Confirm the reported code matches react-doctor/rn-bottom-sheet-use-integrated-scrollable. Compare it with the Before example and verify the same API, framework, and execution context. Treat it as a false positive only when one of those conditions differs.

Compare the code

The corrected pattern shows a focused way to address the diagnostic.

Reported pattern

import BottomSheet from "@gorhom/bottom-sheet";
import { ScrollView } from "react-native";

<BottomSheet>
  <ScrollView>{content}</ScrollView>
</BottomSheet>

Corrected pattern

import BottomSheet, {
  BottomSheetScrollView,
} from "@gorhom/bottom-sheet";

<BottomSheet>
  <BottomSheetScrollView>
    {content}
  </BottomSheetScrollView>
</BottomSheet>

How to fix

Use the corrected pattern as a reference. Preserve behavior that the rule does not require you to change.

Copyable fix prompt

Copy this self-contained prompt into your coding agent after you confirm the diagnostic.

Fix every confirmed react-doctor/rn-bottom-sheet-use-integrated-scrollable diagnostic in the current repository. Required change: - Use @gorhom/bottom-sheet's integrated BottomSheetScrollView, BottomSheetFlatList, BottomSheetSectionList, or BottomSheetVirtualizedList so gestures coordinate with the sheet.

Reference transformation:Before:

import BottomSheet from "@gorhom/bottom-sheet";
import { ScrollView } from "react-native";

<BottomSheet>
  <ScrollView>{content}</ScrollView>
</BottomSheet>

After:

import BottomSheet, {
  BottomSheetScrollView,
} from "@gorhom/bottom-sheet";

<BottomSheet>
  <BottomSheetScrollView>
    {content}
  </BottomSheetScrollView>
</BottomSheet>

Constraints: - Confirm the reported code matches the Before pattern. - Make the smallest change that fixes the root cause. - Preserve behavior and interfaces unrelated to this diagnostic. - Reuse existing project components, utilities, and conventions. - Do not introduce render-phase side effects, render-phase state updates, or Hooks rule violations. - Adapt identifiers and framework details instead of copying blindly. - Do not disable the rule or suppress matching code. - Confirm this rule is enabled for the project: react-native. Verification: - Run focused tests for the changed behavior. - Run React Doctor and confirm this diagnostic no longer appears. - Report the files changed and any checks you could not run.

More Bugs rules from the rules reference:

react-doctor/rn-detox-missing-await: Prepend await to the Detox action, waitFor chain, or expect(element(...)) assertion: await element(by.id('submit')).tap()
react-doctor/rn-list-callback-per-row: Hoist the handler with useCallback at list scope and pass the row id as a primitive prop, so the row's memo() shallow-compare actually hits
react-doctor/rn-list-data-mapped: Wrap the projection in `useMemo(() => items.map(...), [items])` so the list's `data` prop has a stable reference across parent renders
react-doctor/rn-list-missing-estimated-item-size: Add estimatedItemSize so FlashList/LegendList sizes its initial container pool correctly: <FlashList data={items} estimatedItemSize={64} />
react-doctor/rn-list-recyclable-without-types: Add `getItemType={item => item.kind}` so FlashList keeps separate recycle pools per item type — heterogeneous rows shouldn't share recycled cells

react-doctor/rn-bottom-sheet-use-integrated-scrollable