https://github.com/2004durgesh/react-native-video-toolkit
A powerful, flexible, and customizable video player UI toolkit for React Native apps. Inspired by Vidstack
https://github.com/2004durgesh/react-native-video-toolkit
react-native react-native-video react-native-video-toolkit video video-controls video-player
Last synced: about 18 hours ago
JSON representation
A powerful, flexible, and customizable video player UI toolkit for React Native apps. Inspired by Vidstack
- Host: GitHub
- URL: https://github.com/2004durgesh/react-native-video-toolkit
- Owner: 2004durgesh
- License: mit
- Created: 2025-08-01T06:25:08.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2026-02-08T12:31:00.000Z (3 months ago)
- Last Synced: 2026-04-12T19:22:20.184Z (15 days ago)
- Topics: react-native, react-native-video, react-native-video-toolkit, video, video-controls, video-player
- Language: TypeScript
- Homepage: https://react-native-video-toolkit-docs.vercel.app/
- Size: 158 MB
- Stars: 5
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
react-native-video-toolkit
My **first ever real OSS project** 😭. Be kind, I’m still figuring this out.
A flexible and customizable video player UI toolkit for React Native.
👉 Full Documentation: [https://react-native-video-toolkit-docs.vercel.app/](https://react-native-video-toolkit-docs.vercel.app/)
---
## 📑 Table of Contents
- [📱 Demo](#-demo)
- [✨ Features](#-features)
- [✅ Platform Compatibility](#-platform-compatibility)
- [🗺️ Roadmap](#-roadmap)
- [📦 Installation](#-installation)
- [🚀 Usage](#-usage)
- [🐛 Issues](#-issues)
- [🤝 Contributing](#-contributing)
- [📜 License](#-license)
---
## 📱 Demo
> [!TIP]
> The demo app is available in the `example` folder.
> Clone the repo and run `yarn example start` inside the `example` directory to see the latest changes.
> You can also download the demo app from the [release builds](https://github.com/2004durgesh/react-native-video-toolkit/releases/latest).
| Mode | Preview |
| ----------------------------- | ----------------------------------------------------- |
| **Portrait** | 
|
| **Landscape** | 
|
| **Landscape (with settings)** | 
|
---
## ✨ Features
- **Fully Customizable UI** – Build your own video player experience with modular components.
- **Theming Support** – Light, dark, or your own custom theme.
- **Pre-built Layouts** – Includes `DefaultLayout` to get started quickly.
- **Gesture Handling** – Tap, double-tap, and other common playback gestures.
- **Rich Component Library** – Controls like `PlayButton`, `ProgressBar`, `TimeDisplay`, `FullscreenButton`, `MuteButton`, and more.
- **Hooks-based API** – Access player state and control playback, settings, and gestures.
---
## ✅ Platform Compatibility
| Platform | Tested |
| ---------- | :----: |
| Android | ✅ |
| iOS | ❌ |
| Android TV | ✅ |
| Apple TV | ❌ |
| Web | ✅ |
---
## 🗺️ Roadmap
- [x] Core Player component
- [x] Customizable controls
- [x] Theming support
- [x] Gesture handling
- [x] Settings menu
- [x] Layout presets (`DefaultLayout`)
- [x] Fullscreen support
- [x] Landscape mode support
- [ ] TV support (D-pad navigation)
- [ ] Picture-in-Picture (PiP) mode
- [ ] More advanced layouts (YouTube/Netflix-style)
---
## 📦 Installation
```bash
npm install react-native-video-toolkit
# or
yarn add react-native-video-toolkit
```
---
## 🚀 Usage
```tsx
import { VideoPlayer, DefaultLayout } from 'react-native-video-toolkit';
const App = () => {
return (
);
};
```
For more docs:
👉 [Documentation website](https://react-native-video-toolkit-docs.vercel.app/).
---
## 🐛 Issues
Yes, there are bugs. Probably lots.
👉 [Open an issue](https://github.com/2004durgesh/react-native-video-toolkit/issues).
It makes the project look active, so actually… thanks in advance.
---
## 🤝 Contributing
Wanna help? Please? 🙏
Check the [contributing guide](CONTRIBUTING.md). I’ll try to review your PR before I spiral into existential dread.
---
## 📜 License
MIT – because lawyers are scary.
---
Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)
Thanks to [wuxnz](https://github.com/wuxnz) for motivation (and maybe trauma)
Thanks to [zach](https://github.com/founded-labs/react-native-reusables/tree/main/apps/docs) for the docs template
Made with ❤️, caffeine, and way too many Chrome tabs by [Durgesh](https://github.com/2004durgesh)