react / react/react-native

Liquid Glass header shadows incorrectly invert when FlatList has inverted={true} on iOS 26

Open
#54,181 19 comments 10 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Component: FlatList iOS 26 Issue: Author Provided Repro Platform: iOS
Dominant language
C++
Stars
127k
Forks
25.3k
Avg merge
1d 23h
Merged PRs (30d)
4

Description

Description

Expected Behavior

When using inverted={true} FlatList, the header shadow/blur should maintain its normal appearance with proper content darkening underneath the transparent header.

Actual Behavior

Liquid Glass interface automatically detects the FlatList inversion and incorrectly inverts the header blur gradient. This causes:

  1. All visible content under the header becomes properly darkened (incorrect)
  2. All content that should be darkened under the header remains fully transparent (incorrect)

The shadow/blur gradient is effectively inverted, creating the opposite visual effect.

migrated from https://github.com/software-mansion/react-native-screens/issues/3293

Steps to reproduce
  1. Setting up headerTransparent: true if using Navigation OR add native elements to ViewController (Searchbar etc.)
  2. Add a FlatList with inverted={true} OR apply transform: [{ scaleY: -1 }]
  3. Scroll the list and observe the header shadow behavior
  4. Compare with a non-inverted FlatList
React Native Version

0.81.4

Affected Platforms

Runtime - iOS

Output of npx @react-native-community/cli info
System:
  OS: macOS 26.0.1
  CPU: (11) arm64 Apple M3 Pro
  Memory: 184.17 MB / 18.00 GB
  Shell:
    version: "5.9"
    path: /bin/zsh
Binaries:
  Node:
    version: 22.14.0
    path: /Users/vasgen/.nvm/versions/node/v22.14.0/bin/node
  Yarn:
    version: 3.6.1
    path: /Users/vasgen/.nvm/versions/node/v22.14.0/bin/yarn
  npm:
    version: 10.9.2
    path: /Users/vasgen/.nvm/versions/node/v22.14.0/bin/npm
  Watchman:
    version: 2025.03.03.00
    path: /opt/homebrew/bin/watchman
Managers:
  CocoaPods:
    version: 1.16.2
    path: /opt/homebrew/bin/pod
SDKs:
  iOS SDK:
    Platforms:
      - DriverKit 25.0
      - iOS 26.0
      - macOS 26.0
      - tvOS 26.0
      - visionOS 26.0
      - watchOS 26.0
  Android SDK:
    API Levels:
      - "34"
    Build Tools:
      - 29.0.2
      - 32.0.0
      - 34.0.0
    System Images:
      - android-34 | Google Play ARM 64 v8a
    Android NDK: Not Found
IDEs:
  Android Studio: 2024.2 AI-242.23339.11.2421.12483815
  Xcode:
    version: 26.0.1/17A400
    path: /usr/bin/xcodebuild
Languages:
  Java:
    version: 17.0.14
    path: /usr/bin/javac
  Ruby:
    version: 2.6.10
    path: /usr/bin/ruby
npmPackages:
  "@react-native-community/cli": Not Found
  react:
    installed: 19.1.0
    wanted: 19.1.0
  react-native:
    installed: 0.81.4
    wanted: 0.81.4
  react-native-macos: Not Found
npmGlobalPackages:
  "*react-native*": Not Found
Android:
  hermesEnabled: Not found
  newArchEnabled: Not found
iOS:
  hermesEnabled: Not found
  newArchEnabled: Not found
Stacktrace or Logs
-
MANDATORY Reproducer

https://snack.expo.dev/@whidrubeld/liquid-glass-header-shadows-incorrectly-invert-when-flatlist-has-inverted

Screenshots and Videos

Example of behavior
Image
Image

ViewController setting up
Image

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 mandatory Snack reproducer and compare the header behavior for inverted and non-inverted FlatList cases on iOS. Use the headerTransparent and ViewController setups, including the scaleY: -1 case, as entry points for investigation. Done means the transparent header keeps the normal shadow and blur gradient, with content darkened correctly beneath it.

Written by the indexing model from the issue text.

Assessment

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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.