feat(MOPRAT-867): Improve keyboard handling across the app #13113

MrSltun · 2025-12-18T18:10:28Z

This PR resolves MOPRAT-867

Description

This PR updates how we handle the keyboard across the app

Videos

Since these changes cover a lot of places, I only recorded a few areas where the effect is very visible

Old (current) keyboard handling implementation

Videos

	Android	iOS
Conversations	keyboard-inquiry-android-before-low.mp4	keyboard-inquiry-ios-before-low.mp4
Complete my Profile	keyboard-complete-profile-android-before-low.mp4	keyboard-complete-profile-ios-before-low.mp4
My Collection	keyboard-my-collection-android-before-low.mp4	keyboard-my-collection-ios-before-low.mp4
Auction Credit Card form	keyboard-credit-card-android-before-low.mp4	keyboard-credit-card-ios-before-low.mp4

New keyboard handling implementation

Videos

	Android	iOS
Conversations	keyboard-inquiry-android-after-low.mp4	keyboard-inquiry-ios-after-low.mp4
Complete my Profile	keyboard-complete-profile-android-after-low.mp4	keyboard-complete-profile-ios-after-low.mp4
My Collection	keyboard-my-collection-android-after-low.mp4	keyboard-my-collection-ios-after-low.mp4
Auction Credit Card form	keyboard-credit-card-android-after-low.mp4	keyboard-credit-card-ios-after-low.mp4

PR Checklist

I have tested my changes on the following platforms:
- Android.
- iOS.
I hid my changes behind a feature flag, or they don't need one.
I have included screenshots or videos at least on Android, or I have not changed the UI.
I have added tests, or my changes don't require any.
I added an app state migration, or my changes do not require one.
I have documented any follow-up work that this PR will require, or it does not require any.
I have added a changelog entry below, or my changes do not require one.

To the reviewers 👀

I would like at least one of the reviewers to run this PR on the simulator or device.

Changelog updates

Cross-platform user-facing changes

iOS user-facing changes

Android user-facing changes

Dev changes

Improve keyboard handling across the app

Need help with something? Have a look at our docs, or get in touch with us.

artsy-peril · 2025-12-18T18:10:40Z

react-native-keyboard-controller

Author: Kiryl Ziusko

Description: Keyboard manager which works in identical way on both iOS and Android

Homepage: https://kirillzyusko.github.io/react-native-keyboard-controller/


Created	over 3 years ago
Last Updated	7 days ago
License	MIT
Maintainers	1
Releases	105
Direct Dependencies	`react-native-is-edge-to-edge`
Keywords	react-native, keyboard, interactive, dismiss, animation, focused input, text changed, selection changed, avoiding view, avoid keyboard, sticky view, over keyboard view, keyboard background view, keyboard aware scroll view, keyboard toolbar, keyboard done button, keyboard next button, keyboard previous button, extend keyboard, ios and android

README

react-native-keyboard-controller

A universal keyboard handling solution for React Native — lightweight, fully customizable, and built for real-world apps. Smooth animations, consistent behavior on both iOS and Android, with a developer-oriented design.

Key features

🧬 Map keyboard movement to animated values
🧪 keyboardWillShow / keyboardWillHide events now available on Android
🔮 Change soft input mode on Android
⚡ Preload keyboard to avoid first-time focus lag
🚀 Reanimated support
📱 Interactive keyboard dismissing 👆📱
📚 Prebuilt components (KeyboardStickyView, KeyboardAwareScrollView, reworked KeyboardAvoidingView)
📐 KeyboardToolbar with customizable previous, next, and done buttons
🌐 Display anything over the keyboard (without dismissing it) using OverKeyboardView
🎨 Match keyboard background with KeyboardBackgroundView
🧩 Extend keyboard with custom buttons/UI via KeyboardExtender
📝 Easy retrieval of focused input info
🧭 Compatible with any navigation library
✨ More coming soon... stay tuned! 😊

Installation

Check out the installation section of the docs for detailed setup instructions.

Documentation

Full API reference and guides available at:
https://kirillzyusko.github.io/react-native-keyboard-controller/

Contributing

See the contributing guide to learn how to contribute to the repo and development workflow.

License

MIT

New dependencies added: react-native-keyboard-controller.

Generated by 🚫 dangerJS against d67da92

artsyit · 2025-12-18T18:11:01Z

New dependencies added: react-native-keyboard-controller.

react-native-keyboard-controller	Used in `package.json`
Author: Kiryl Ziusko	Description: Keyboard manager which works in identical way on both iOS and Android
License: MIT	Homepage: https://kirillzyusko.github.io/react-native-keyboard-controller/
Keywords: react-native, keyboard, interactive, dismiss, animation, focused input, text changed, selection changed, avoiding view, avoid keyboard, sticky view, over keyboard view, keyboard background view, keyboard aware scroll view, keyboard toolbar, keyboard done button, keyboard next button, keyboard previous button, extend keyboard, ios and android
Updated: 7 days ago	Created: over 3 years ago
Releases: 105	Maintainers: 1
Direct Dependencies: `react-native-is-edge-to-edge`

README

react-native-keyboard-controller

A universal keyboard handling solution for React Native — lightweight, fully customizable, and built for real-world apps. Smooth animations, consistent behavior on both iOS and Android, with a developer-oriented design.

Key features

🧬 Map keyboard movement to animated values
🧪 keyboardWillShow / keyboardWillHide events now available on Android
🔮 Change soft input mode on Android
⚡ Preload keyboard to avoid first-time focus lag
🚀 Reanimated support
📱 Interactive keyboard dismissing 👆📱
📚 Prebuilt components (KeyboardStickyView, KeyboardAwareScrollView, reworked KeyboardAvoidingView)
📐 KeyboardToolbar with customizable previous, next, and done buttons
🌐 Display anything over the keyboard (without dismissing it) using OverKeyboardView
🎨 Match keyboard background with KeyboardBackgroundView
🧩 Extend keyboard with custom buttons/UI via KeyboardExtender
📝 Easy retrieval of focused input info
🧭 Compatible with any navigation library
✨ More coming soon... stay tuned! 😊

Installation

Check out the installation section of the docs for detailed setup instructions.

Documentation

Full API reference and guides available at:
https://kirillzyusko.github.io/react-native-keyboard-controller/

Contributing

See the contributing guide to learn how to contribute to the repo and development workflow.

License

MIT

Generated by 🚫 dangerJS against d67da92

github-actions · 2025-12-19T13:38:54Z

🎉 Beta Versions Generated (commit: `995ea05`)

Android 🤖

8.91.0 (2025121913) - Available on Firebase
8.91.0 (2025121913) - Available on Play Store

iOS 🍏

8.91.0 (2025.12.19.13) - Available on Firebase
8.91.0 (2025.12.19.13) - Available on TestFlight

github-actions · 2025-12-23T17:52:38Z

🎉 Beta Versions Generated (commit: `7ccfdec`)

Android 🤖

8.91.0 (2025122317) - Available on Play Store
8.91.0 (2025122317) - Available on Firebase

iOS 🍏

8.91.0 (2025.12.23.17) - Available on TestFlight
8.91.0 (2025.12.23.17) - Available on Firebase

MounirDhahri · 2025-12-29T09:59:24Z

This is impressive work @MrSltun and is a great wrap for 2025!
I see improvements literally on all screens and pretty old issues finally fixed. Proper keyboard handling is key for a great UX and you nailed it with this one 👏🏽 - Thanks

olerichter00

Great work! 🌟

brainbicycle · 2025-12-29T10:53:43Z

.eslintrc.js

+            name: "react-native",
+            importNames: ["Keyboard"],
+            message:
+              "Please use KeyboardController from 'react-native-keyboard-controller' instead.",


brainbicycle

looks great! ✨ love the more consistent floating buttons, I bet we might even see a small bump in some completion metrics on some of these forms, registrations, my profile additions.

Small request, I think we should keep the habit of RFCs for big dep additions, I don't think this one is controversial at all, seems well supported and a solid UX improvement but would be good to just document the why and the decision via an RFC: #12680 just a couple paragraphs and a link to this PR is plenty.

…oidingView also, delete MyAccountFieldEditScreen and BillingAddress components since they're not being used anywhere

Replacing the use of KeyboardAvoidingView + ScrollView

by opening the country picker modal from "Next" button on the keyboard

ArtsyOpenSource · 2026-01-06T12:03:45Z

This PR contains the following changes:

Dev changes (Improve keyboard handling across the app - MrSltun)

Generated by 🚫 dangerJS against d67da92

dariakoko

Great work Sultan!

github-actions · 2026-01-07T12:28:00Z

🎉 Beta Versions Generated (commit: `d67da92`)

Android 🤖

8.91.0 (2026010712) - Available on Play Store
8.91.0 (2026010712) - Available on Firebase

iOS 🍏

8.91.0 (2026.01.07.12) - Available on Firebase
8.91.0 (2026.01.07.12) - Available on TestFlight

MrSltun self-assigned this Dec 18, 2025

artsy-peril bot added the Jira Synced label Dec 18, 2025

MrSltun changed the title ~~feat: Improve keyboard handling across the app~~ feat(MOPRAT-867): Improve keyboard handling across the app Dec 19, 2025

MrSltun requested review from MounirDhahri, araujobarret, brainbicycle, dariakoko and gkartalis December 24, 2025 18:19

MrSltun marked this pull request as ready for review December 24, 2025 18:19

MrSltun requested a review from olerichter00 December 24, 2025 18:20

olerichter00 previously approved these changes Dec 29, 2025

View reviewed changes

brainbicycle reviewed Dec 29, 2025

View reviewed changes

brainbicycle previously approved these changes Dec 29, 2025

View reviewed changes

araujobarret previously approved these changes Dec 29, 2025

View reviewed changes

MrSltun mentioned this pull request Jan 5, 2026

[RFC] New dependency: react-native-keyboard-controller #13125

Open

gkartalis linked an issue Jan 6, 2026 that may be closed by this pull request

[RFC] New dependency: react-native-keyboard-controller #13125

Open

MrSltun dismissed stale reviews from araujobarret, brainbicycle, and olerichter00 via a85cf6b January 6, 2026 11:16

artsy deleted a comment from ArtsyOpenSource Jan 6, 2026

MrSltun added 5 commits January 6, 2026 12:25

feat: Add react-native-keyboard-controller

7a63320

feat(MOPRAT-868): add KeyboardAvoidingContainer

a7a2a71

feat(MOPRAT-869): add KeyboardAwareForm container

0dbd5d7

add BottomSheetKeyboardAwareScrollView

8d73b65

feat(MOPRAT-871): use KeyboardAvoidingContainer instead of KeyboardAv…

df78f46

…oidingView also, delete MyAccountFieldEditScreen and BillingAddress components since they're not being used anywhere

MrSltun added 15 commits January 6, 2026 12:25

feat(MOPRAT-872): use KeyboardAwareForm

940658f

Replacing the use of KeyboardAvoidingView + ScrollView

feat(MOPRAT-873): use KeyboardStickyView

22ad310

use KeyboardAvoidingContainer in Composer

eb14db5

use BottomSheetKeyboardAwareScrollView

5578b06

remove unused imports

2f43f72

add keyboard controller mock

d0a69ec

add bottom sheet mocks

abf982b

update bottom sheet mock and remove keyboard provider from tests

66e7222

use KeyboardController instead of react-native Keyboard

cb2c8b7

fix visual issues across different screens

b11ed98

fix country picker accessibility issue

a13a701

by opening the country picker modal from "Next" button on the keyboard

more visual fixes

452eddd

more fixes

f2a9f5b

refactor: calculated offset instead of hardcoded values

9ef17be

add keyboard management section in best practices

e35e390

MrSltun force-pushed the mrsltun/MOPRAT-867/improve-keyboard-handling branch from a85cf6b to e35e390 Compare January 6, 2026 11:26

artsy deleted a comment from ArtsyOpenSource Jan 6, 2026

MrSltun added 3 commits January 6, 2026 13:00

use keyboard controller in credit card form

938936a

update default bottom offset in KeyboardAwareForm

e392eba

update keyboard handling docs

d67da92

artsy deleted a comment from ArtsyOpenSource Jan 6, 2026

dariakoko reviewed Jan 7, 2026

View reviewed changes

feat(MOPRAT-867): Improve keyboard handling across the app #13113

Are you sure you want to change the base?

feat(MOPRAT-867): Improve keyboard handling across the app #13113

Conversation

MrSltun commented Dec 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Videos

Old (current) keyboard handling implementation

New keyboard handling implementation

PR Checklist

To the reviewers 👀

Changelog updates

Cross-platform user-facing changes

iOS user-facing changes

Android user-facing changes

Dev changes

Uh oh!

artsy-peril bot commented Dec 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

react-native-keyboard-controller

react-native-keyboard-controller

Key features

Installation

Documentation

Contributing

License

Uh oh!

artsyit commented Dec 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

react-native-keyboard-controller

react-native-keyboard-controller

Key features

Installation

Documentation

Contributing

License

Uh oh!

github-actions bot commented Dec 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🎉 Beta Versions Generated (commit: 995ea05)

Android 🤖

iOS 🍏

Uh oh!

github-actions bot commented Dec 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🎉 Beta Versions Generated (commit: 7ccfdec)

Android 🤖

iOS 🍏

Uh oh!

MounirDhahri commented Dec 29, 2025

Uh oh!

olerichter00 left a comment

Choose a reason for hiding this comment

Uh oh!

brainbicycle Dec 29, 2025

Choose a reason for hiding this comment

Uh oh!

brainbicycle left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ArtsyOpenSource commented Jan 6, 2026

This PR contains the following changes:

Uh oh!

dariakoko left a comment

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Jan 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🎉 Beta Versions Generated (commit: d67da92)

Android 🤖

iOS 🍏

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

MrSltun commented Dec 18, 2025 •

edited

Loading

artsy-peril bot commented Dec 18, 2025 •

edited

Loading

artsyit commented Dec 18, 2025 •

edited

Loading

github-actions bot commented Dec 19, 2025 •

edited

Loading

🎉 Beta Versions Generated (commit: `995ea05`)

github-actions bot commented Dec 23, 2025 •

edited

Loading

🎉 Beta Versions Generated (commit: `7ccfdec`)

brainbicycle left a comment •

edited

Loading

github-actions bot commented Jan 7, 2026 •

edited

Loading

🎉 Beta Versions Generated (commit: `d67da92`)