docs: new video in readme (#935)

## 📜 Description

Update README to make it easier-to-read.

## 💡 Motivation and Context

The old README was created 3 years ago. Back to times the website didn't
have brand specific colors and old video had a lot of downsides: visible
mac cursor, desynchronizsed animation on Android, inconsistent UI on
iOS/Android etc.

I wanted to re-work the README for a long time, and now this time has
came 😊 I added a better video (see changelog below), re-structured
layout, re-phrased slogan etc.

Overall I think new version looks much-much better 😎 

## 📢 Changelog

<!-- High level overview of important changes -->
<!-- For example: fixed status bar manipulation; added new types
declarations; -->
<!-- If your changes don't affect one of platform/language below - then
remove this platform/language -->

### Video

- uses brand colors
- don't have "header"
- uses translucent status bar on Android (identical to iOS)
- fixed Android desynzchronized animation
- smaller video size
- video doesn't take 50% of screen width
- messages don't include text, so it doesn't distract user
- videos are framed in iPhone/Android skins for easier OS distinguishing

### Docs

- re-arrange features and video in the same container (text from left,
video from right)
- change h2 to h3 to avoid auto-"hr" lines
- use emoji in the beginning of each item
- keep `.gif` to make sure that old demo is still shown on `npm`
- re-phrase key features (thanks @hirbod)
- change intro/library slogan

### CI

- exclude `.apng` (`demo.png`) from being compressed;

## 🤔 How Has This Been Tested?

Tested via GH preview.

## 📸 Screenshots (if appropriate):

<img width="917" alt="image"
src="https://github.com/user-attachments/assets/ebc603d5-90a2-4f0c-a3be-8dc0db176ff6"
/>

## 📝 Checklist

- [x] CI successfully passed
- [x] I added new mocks and corresponding unit-tests if library API was
changed

---------

Co-authored-by: Hirbod <[email protected]>

Author: kirillzyusko

.github/workflows/compress-images.yml

@@ -26,7 +26,7 @@ jobs:
           # The `GITHUB_TOKEN` is automatically generated by GitHub and scoped only to the repository that is currently running the action. By default, the action can’t update Pull Requests initiated from forked repositories.
           # See https://docs.github.com/en/actions/reference/authentication-in-a-workflow and https://help.github.com/en/articles/virtual-environments-for-github-actions#token-permissions
           githubToken: ${{ secrets.GITHUB_TOKEN }}
-          ignorePaths: "e2e/**"
+          ignorePaths: "e2e/**,gifs/demo.png"
           jpegQuality: "80"
           jpegProgressive: false
           pngQuality: "80"

README.md

@@ -1,37 +1,38 @@
 # react-native-keyboard-controller
 
-Keyboard manager which works in identical way on both iOS and Android.
+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.
 
-## Demonstration
+<div>
+  <img align="right" width="32%" src="./gifs/demo.png?raw=true">
+</div>
 
-<img src="./gifs/demo.gif?raw=true" width="60%">
+### Key features
 
-## Key features
+- 🧬 Map keyboard movement to animated values
+- 🧪 `keyboardWillShow` / `keyboardWillHide` events now available on Android
+- ⚡ Change soft input mode on Android
+- 🚀 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`
+- 📝 Easy retrieval of focused input info
+- 🧭 Compatible with any navigation library
+- ✨ More coming soon... stay tuned! 😊
 
-- mapping keyboard movement to animated values 😎
-- missing `keyboardWillShow` / `keyboardWillHide` events are available on Android 😍
-- module for changing soft input mode on Android 🤔
-- reanimated support 🚀
-- interactive keyboard dismissing 👆📱
-- prebuilt components (`KeyboardStickyView`, `KeyboardAwareScrollView`, re-worked `KeyboardAvoidingView`) 📚
-- `KeyboardToolbar` with easy behavior customization of _**previous**_, _**next**_ and _**done**_ buttons in the keyboard toolbar 📐
-- show anything over the keyboard (without dismissing it) using `OverKeyboardView` 🌐
-- easy focused input information retrieval 📝 🔮
-- works with any navigation library 🧭
-- and more is coming... Stay tuned! 😊
+### Installation
 
-## Installation
+Check out the [installation](https://kirillzyusko.github.io/react-native-keyboard-controller/docs/installation) section of the docs for detailed setup instructions.
 
-Check out the [installation](https://kirillzyusko.github.io/react-native-keyboard-controller/docs/installation) section of docs for the detailed installation instructions.
+### Documentation
 
-## Documentation
+Full API reference and guides available at:  
+[https://kirillzyusko.github.io/react-native-keyboard-controller/](https://kirillzyusko.github.io/react-native-keyboard-controller/)
 
-Check out the dedicated documentation page for information about this library, API reference and more: [https://kirillzyusko.github.io/react-native-keyboard-controller/](https://kirillzyusko.github.io/react-native-keyboard-controller/)
+### Contributing
 
-## Contributing
+See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repo and development workflow.
 
-See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.
-
-## License
+### License
 
 MIT