Repository navigation
Description
If you haven’t already, check out our contributing guidelines for onboarding and email contributors@expensify.com to request to join our Slack channel!
Version Number:
Reproducible in staging?: Y
Reproducible in production?:
If this was caught during regression testing, add the test name, ID and link from TestRail:
Email or phone of affected tester (no customers):
Logs: https://stackoverflow.com/c/expensify/questions/4856
Expensify/Expensify Issue URL:
Issue reported by: @mountiny
Slack conversation (hyperlinked to channel name):
Regression
This is a regression of ios 26 keyboard jumps when composer is being focused, which was closed on 2026-03-11. These PRs fixed it by updating react-native-keyboard-controller:
- fix: missing animations in
- fix: update RNKC and RNPV to latest versions
- fix: missing keyboard animations
A candidate cause (not verified) is the later react-native-keyboard-controller upgrade in Upgrade react-native-keyboard-controller before RN 0.86 bump.
Action Performed:
The original issue reproduced on iOS 26 only, not on iOS 18.
- Open some report
- Click on the composer
Expected Result:
The composer should animate smoothly with the keyboard opening
Actual Result:
The page/ composer jumps after the keyboard opens smoothly
Workaround:
None needed, the composer still works. The animation is not smooth.
Platforms:
Select the officially supported platforms where the issue was reproduced:
- Android: App
- Android: mWeb Chrome
- iOS: App
- iOS: mWeb Safari
- iOS: mWeb Chrome
- Windows: Chrome
- MacOS: Chrome / Safari
- MacOS: Desktop
Platforms Tested:
On which of our officially supported platforms was this issue tested:- Android: App
- Android: mWeb Chrome
- iOS: App
- iOS: mWeb Safari
- iOS: mWeb Chrome
- Windows: Chrome
- MacOS: Chrome / Safari
- MacOS: Desktop
Screenshots/Videos
Add any screenshot/video evidence
Issue Owner
Current Issue Owner: @jmusialUpwork Automation - Do Not Edit
- Upwork Job URL: https://www.upwork.com/jobs/~022117366330813071857
- Upwork Job ID: 2117366330813071857
- Last Price Increase: 2026-11-02
Metadata
Metadata
Assignees
Labels
Type
Projects
- StatusShow more project fieldsCRITICAL
Activity
MelvinBot commentedon Nov 2, 2026
I couldn't find an App code change that explains the jump. The likely cause is the keyboard library (
react-native-keyboard-controller, RNKC). The fix for [Due for payment soon?] [$500] ios 26 keyboard jumps when composer is being focused came only from RNKC upgrades. Since then, the App's keyboard handling on the report screen has barely changed. RNKC has been upgraded twice: chore: upgrade react-native-keyboard-controller to 1.22.2 on 2026-07-29 and chore: upgrade react-native-keyboard-controller to 1.22.4 on 2026-09-11.The report screen's keyboard handling is unchanged. RNKC's
KeyboardAvoidingViewwithbehavior="padding"wraps the screen in ScreenWrapperContainer.tsx:94 and ScreenWrapperContainer.tsx:201-216. The report screen turns it on in ReportScreen.tsx:116.I couldn't verify this because the bug only happens on iOS 26. I couldn't reproduce it here, and nobody has pinned down which build brought it back. To confirm:
keyboardWillShowas an open keyboard and shadow node sync on iOS. This is the cheapest test.onStart/onMove/onEndwhile you tap the composer. IfonMovefires rarely or never andonEndsnaps into place, the bug matches the upstream reports below. Also loguseSafeAreaInsets().bottombefore and after the keyboard opens. If it changes, the bottom spacer could push the composer.Investigation details
RNKC versions used by the App
The App's own RNKC patch (
fix-insets-in-landscape) only changes Android code.Upstream RNKC changes, 1.21.0-beta.1 → 1.22.4
The iOS code that animates the keyboard opening is nearly identical in both versions. The JS hooks the App uses (
KeyboardAvoidingView,useKeyboardHandler) are also unchanged. One related change:Another upstream report shows a similar pattern: iOS 26:
onMoveis never called after app relaunch in Release builds, soKeyboardAwareScrollViewdoesn't scroll to the focused input. It was closed with advice to upgrade, but nobody shared a reproduction.App-side review
I checked the PRs merged since 2026-02-11 that touched the report screen's keyboard handling. None adds a second layout change after the keyboard opens:
keyboardDidShowlistener is in withKeyboardState.tsx:43. The composer uses it only to decide hotkeys, not for layout.CollapsibleHeaderOnKeyboardonly runs in landscape.Other possible causes (unverified)
Next Steps: Reply with
@MelvinBot <your feedback>to refine this analysis. For example, tell me whether RNKC 1.22.9 fixes it, or which build first showed the jump.view run
melvin-bot commentedon Nov 2, 2026
Triggered auto assignment to Contributor-plus team member for initial proposal review - @Eskalifer1 (
External)[-]Regression: iOS 26 keyboard jumps when composer is being focused[/-][+][$175] Regression: iOS 26 keyboard jumps when composer is being focused[/+]melvin-bot commentedon Nov 2, 2026
Job added to Upwork: https://www.upwork.com/jobs/~022117366330813071857
camesenin commentedon Nov 2, 2026
melvin-bot commentedon Nov 2, 2026
✅ Contributor details stored successfully. Thank you for contributing to Expensify!
Eskalifer1 commentedon Nov 3, 2026
Hi @jmusial are you going to work on this one?
jmusial commentedon Nov 3, 2026
HEy @Eskalifer1, yes will pick it up today / tomorrow
Eskalifer1 commentedon Nov 3, 2026
All right, I get it, thanks! I just wasn't sure if you'd be working on the issue or if I should follow the standard workflow.
jmusial commentedon Nov 4, 2026
Update: Two bugs cause this behaviour.
ReportScreenonly turns on itsKeyboardAvoidingViewoncecurrentReportIDupdates, and since PR #87768 that update runs in astartTransitionthat can lag several seconds when a heavy report opens. Gating on the navigation state instead fixes this onAndroid.On iOS,
Reanimated's commit pausing holds back the keyboard padding updates until the JS thread commits again. Turning onDISABLE_COMMIT_PAUSING_MECHANISMremoved that delay in tests.I'm trying to find an alternative that would not require turning a global flag on.
Android
android-full-3way-realtime.mp4
ios
ios-full-3way-realtime.mp4
mountiny commentedon Nov 5, 2026
Nice findings!
jeffrey-graham commentedon Nov 7, 2026
melvin-bot commentedon Nov 7, 2026
TassioSales commentedon Nov 8, 2026
Proposal
Please re-state the problem that we are trying to solve in this issue.
On iOS, focusing the chat composer causes the virtual keyboard to stutter or jump abruptly.
What is the root cause of that problem?
In
ReportActionCompose.tsx/CustomKeyboardAvoidingView:When the text input is focused, both the native iOS keyboard event listener (
keyboardWillShow) andKeyboardAvoidingViewtrigger simultaneous layout shifts. In addition,setComposerHeightexecutes asynchronously in response toonContentSizeChange, applying conflicting height adjustments during the keyboard animation window.What changes do you think we should make in order to solve the problem?
CustomKeyboardAvoidingViewon iOS:keyboardWillShowandkeyboardWillHideexclusively with native driver animation easing curves to align layout adjustments with the native keyboard frame.ReportActionCompose.tsx:What alternative solutions did you explore? (Optional)
Switching
behavior="position", butbehavior="padding"with synchronized native animation curves delivers smooth transitions without layout jumps.mountiny commentedon Nov 8, 2026
This is not open for proposals
melvin-bot commentedon Nov 9, 2026
@jmusial Huh... This is 4 days overdue. Who can take care of this?
jmusial commentedon Nov 10, 2026
Not overdue, working on it.