Shopify / Shopify/flash-list

Large blank space when using automaticallyAdjustKeyboardInsets

Open
#2,066 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug P2
Dominant language
TypeScript
Stars
7.2k
Forks
393
Avg merge
1d 3h
Merged PRs (30d)
1

Description

Description

I have a flash list that displays chat messages.
I enabled automaticallyAdjustKeyboardInsets so that the flash list follows the keyboard opening and closing.

Since I moved to v2 the animation is much smoother, however I run into a bug where upon the keyboard being dismissed, a huge blank space appears at the bottom of the list.

This doesn't happen with automaticallyAdjustKeyboardInsets={false}, however I find no better way of managing the keyboard.
I also tried wrapping the flash list in a <KeyboardAvoidingView behavior="padding" />, however when the keyboard is dismissed, the whole screen turns blank.

Current behavior

https://github.com/user-attachments/assets/2802aad3-ca40-4436-a6d3-19a74efe8664

Expected behavior

For the blank space not to be there, just like when automaticallyAdjustKeyboardInsets={false}.

Reproduction

<FlashList
  ref={listRef}
  data={hydratedMessages}
  renderItem={renderItem}
  keyExtractor={(item) => item.message.id}
  getItemType={(item) => item.message.content.type}
  onStartReached={endReached}
  keyboardDismissMode={
    Platform.OS === "ios" ? "interactive" : "on-drag"
  }
  maintainVisibleContentPosition={{
    startRenderingFromBottom: true,
    autoscrollToBottomThreshold: 0.2,
  }}
  automaticallyAdjustKeyboardInsets={true}
/>

Platform

  • iOS
  • Android
  • Web (if applicable)

Environment

React Native info output:
System:
  OS: macOS 26.2
  CPU: (10) arm64 Apple M1 Pro
  Memory: 868.50 MB / 16.00 GB
  Shell:
    version: "5.9"
    path: /bin/zsh
Binaries:
  Node:
    version: 22.14.0
    path: /Users/nick/.nvm/versions/node/v22.14.0/bin/node
  Yarn: Not Found
  npm:
    version: 11.3.0
    path: /Users/nick/.nvm/versions/node/v22.14.0/bin/npm
  Watchman:
    version: 2025.12.29.00
    path: /opt/homebrew/bin/watchman
Managers:
  CocoaPods:
    version: 1.15.2
    path: /Users/nick/.gem/ruby/2.7.7/bin/pod
SDKs:
  iOS SDK:
    Platforms:
      - DriverKit 25.2
      - iOS 26.2
      - macOS 26.2
      - tvOS 26.2
      - visionOS 26.2
      - watchOS 26.2
  Android SDK: Not Found
IDEs:
  Android Studio: 2024.1 AI-241.18034.62.2412.12266719
  Xcode:
    version: 26.2/17C52
    path: /usr/bin/xcodebuild
Languages:
  Java:
    version: 17.0.17
    path: /usr/bin/javac
  Ruby:
    version: 2.7.7
    path: /opt/homebrew/opt/ruby@2.7/bin/ruby
npmPackages:
  "@react-native-community/cli": Not Found
  react:
    installed: 19.0.0
    wanted: 19.0.0
  react-native:
    installed: 0.79.6
    wanted: 0.79.6
  react-native-macos: Not Found
npmGlobalPackages:
  "*react-native*": Not Found
Android:
  hermesEnabled: Not found
  newArchEnabled: Not found
iOS:
  hermesEnabled: Not found
  newArchEnabled: Not found

FlashList version: 2.2.0

Additional context

Checklist

  • I've searched existing issues and couldn't find a duplicate
  • I've provided a minimal reproduction (Expo Snack preferred)
  • I'm using the latest version of @shopify/flash-list
  • I've included all required information above

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the supplied FlashList reproduction using automaticallyAdjustKeyboardInsets on iOS and FlashList 2.2.0, then reproduce the blank space after dismissing the keyboard. Compare it with automaticallyAdjustKeyboardInsets={false} and verify that dismissing the keyboard leaves no extra space.

Written by the indexing model from the issue text.

Assessment

Tech stack
react-native, typescript
Domain
mobile
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.