Modal `formSheet` backdrop fade animation missing on first modal creating unsmooth experience.
Nobody has claimed this yet.
- Dominant language
- C++
- Stars
- 127k
- Forks
- 25.3k
- Avg merge
- 1d 23h
- Merged PRs (30d)
- 4
Description
Description
When presenting a <Modal> with presentationStyle="formSheet" and animationType="slide", the backdrop dimming overlay does not fade in on physical iOS devices. Instead, the dimming appears instantly without animation when the first modal opens, results in a jarring, unsmooth appearance when opening modals.
Native apps do not have this problem, so it is unfortunate that all react-native apps suffer from this visual downgrade.
The modal sheet itself slides up correctly, only the backdrop transition is broken.
Notably:
- The second modal's backdrop animates correctly
- Modal dismissal backdrop fade-out always works correctly
- The iOS Simulator works correctly - the bug only appears on physical hardware
This was originally reported against react-native-screens (https://github.com/software-mansion/react-native-screens/issues/2977), but the issue reproduces with React Native's built-in <Modal>.
Steps to reproduce
- Create a fresh React Native 0.84 project
- Use the reproduction code below
- Build and run on a physical iOS device
- Tap "Open Modal 1" — observe the backdrop appears instantly (no fade)
- Tap "Open Modal 2" — observe the backdrop fades in correctly this time
- Close both modals and repeat — the first modal's backdrop never animates
React Native Version
0.84.0
Affected Platforms
Runtime - iOS
Output of npx @react-native-community/cli info
System:
OS: macOS 15.6
CPU: (14) arm64 Apple M4 Pro
Memory: 3.64 GB / 64.00 GB
Shell:
version: "5.9"
path: /bin/zsh
Binaries:
Node:
version: 22.13.0
path: /Users/kris/.nvm/versions/node/v22.13.0/bin/node
Yarn:
version: 1.22.22
path: /Users/kris/.nvm/versions/node/v22.13.0/bin/yarn
npm:
version: 10.9.2
path: /Users/kris/.nvm/versions/node/v22.13.0/bin/npm
Watchman:
version: 2024.12.02.00
path: /opt/homebrew/bin/watchman
Managers:
CocoaPods:
version: 1.16.2
path: /Users/kris/.rbenv/shims/pod
SDKs:
iOS SDK:
Platforms:
- DriverKit 24.4
- iOS 18.4
- macOS 15.4
- tvOS 18.4
- visionOS 2.4
- watchOS 11.4
Android SDK: Not Found
IDEs:
Android Studio: 2024.2 AI-242.23726.103.2422.12816248
Xcode:
version: 16.3/16E140
path: /usr/bin/xcodebuild
Languages:
Java:
version: 17.0.13
path: /usr/bin/javac
Ruby:
version: 3.1.6
path: /Users/kris/.rbenv/shims/ruby
npmPackages:
"@react-native-community/cli":
installed: 20.1.0
wanted: 20.1.0
react:
installed: 19.2.3
wanted: 19.2.3
react-native:
installed: 0.84.1
wanted: 0.84.1
react-native-macos: Not Found
npmGlobalPackages:
"*react-native*": Not Found
Android:
hermesEnabled: true
newArchEnabled: true
iOS:
hermesEnabled: true
newArchEnabled: true
Stacktrace or Logs
None
MANDATORY Reproducer
https://snack.expo.dev/@supermelle/modal-native
Screenshots and Videos
In this video it it shown, how the animation on the first backdrop is missing, and also how it is working on the second modal.
https://github.com/user-attachments/assets/ba417a57-1b14-44b2-a197-59d5f3ffb3fa
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the mandatory Snack reproducer and run it on a physical iOS device, comparing the first and second formSheet modals with animationType="slide". Trace the built-in React Native Modal presentation path for the backdrop transition. Done means the first modal's backdrop fades in smoothly on physical hardware while dismissal and subsequent modals remain correct.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- react-native
- Domain
- mobile-dev
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100