KeyboardAwareScrollView does not work.

[nicolaosm]

Describe the bug
When opening a modal with a text input field, if we focus on some text that is below the keyboard, the keyboard comes in but half of the time the view does not scroll to show the user where is the focused caret.

Code snippet
Added a new clear repo to demonstrate the issue.

Repo for reproducing
https://github.com/nicolaosm/broken-keyboard/

To Reproduce
Just focus on text that is at the bottom part of the screen. The keyboard comes in but the KeyboardAwareScrollView does not scroll to show the cursor.

Expected behavior
When focusing on text, it should always autoscroll to show us where we're typing.

Screenshots
Short screen recording: https://cln.sh/2ZXqZKKS

Smartphone (please complete the following information):

• Desktop OS: MacOS 26.3
• Device: Phone17 Pro Max. (Simulator and Device)
• OS: iOS 26.2
• RN version: 0.83
• RN architecture: New
• JS engine: [e.g. JSC, Hermes, v8]
• Library version: 1.20.7 (Latest)

Additional context
None.

[nicolaosm]

Hi @kirillzyusko ! It's been a minute since late 2024.

You might want to see this issue. Thats our primary use case and it's broken. Thanks ❤️

[kirillzyusko]

Hey @nicolaosm

Thank you for raising the issue! I strongly believe I fixed it in #1234

Could you please check 1.21.0-beta.3 (or 1.21.0-beta.0, this is the first version of the package where the fix is available and it doesn't contain other potentially major/breaking changes) version and let me know if it has been fixed there? 🙏

[nicolaosm]

Thanks @kirillzyusko ! Checking and will get back to you shortly.

[nicolaosm]

Hi @kirillzyusko ! I tested thoroughly on sim and device and yes it's fixed 🎉 Thank you.

A new issue showed up though with the new fix.

👉 With extraKeyboardSpace set, sometimes isn't working after the KeyboardAwareScrollView auto scrolls. Here's a short screen recording: https://cln.sh/WnCdrwqK

(also even when extraKeyboardSpace works, the auto scroll looks like it happens in two parts which is a bit annoying for UX)

[kirillzyusko]

@nicolaosm this is indeed strange. Which changes do I need to make in example app in order to reproduce this problem? Just setting static extraKeyboardSpace? Also do you need to specify extraKeyboardSpace in your case? I think what you are trying to achieve there should be achievable using bottomOffset? Does this problem happens only on iOS 26 or iOS 18 also has this problem?

Could you please provide minimal reproduction example? 👀

When you provide it I'll be happy to look into the problem, this two-fold animation seems to be indeed strange!

[nicolaosm]

Yes, all I did was update to 1.21.0-beta.3 and added extraKeyboardSpace = 30

I also updated the repo here: https://github.com/nicolaosm/broken-keyboard/

To replicate:

1. Open the modal
2. Add caret focus somewhere at the bottom part of the screen.

Result:

• The scroll animation happens in two-fold every single time.
• You might need to try few times to see the bug where extraKeyboardSpace is not added at all.

Let me know if that helps!

Thanks @kirillzyusko

PS: Yes we definitely need the extraKeyboardSpace otherwise the typing is TOO close to the keyboard.

[nicolaosm]

Btw @kirillzyusko, these issues seem to be only affecting iOS. I tested on Android simulator and it works perfectly there.

[kirillzyusko]

Okay, this second animation is caused by this code (called by UIKit when keyboard finished the animation):

- (void)scrollRectToVisible:(CGRect)rect animated:(BOOL)animated
{
  // Limiting scroll area to an area where we actually have content.
  CGSize contentSize = self.contentSize;
  UIEdgeInsets contentInset = self.contentInset;
  CGSize fullSize = CGSizeMake(
      contentSize.width + contentInset.left + contentInset.right,
      contentSize.height + contentInset.top + contentInset.bottom);

  rect = CGRectIntersection((CGRect){CGPointZero, fullSize}, rect);
  if (CGRectIsNull(rect)) {
    return;
  }

  [super scrollRectToVisible:rect animated:animated];
}

I've tried to specify both bottomOffset and extraKeyboardSpace = 30 but it still has second animation 🤔

I need to debug more to understand the issue better!