# React Native Youtube Bridge

## Guide

- [1.x Overview](/1.x/guide/getting-started/overview.md): Version 1.x is the legacy component-based API for react-native-youtube-bridge. It wraps the YouTube IFrame Player API for React Native apps and uses a single YoutubePlayer component with callback props and an imperative ref.
- [Installation](/1.x/guide/getting-started/installation.md): Install the 1.x package:
- [Quick Start](/1.x/guide/getting-started/quick-start.md)
- [AI](/1.x/guide/getting-started/ai.md): To help AI better understand this library's 1.x behavior, documentation, and project conventions so it can provide more accurate help during development and troubleshooting, this project provides the following capabilities:
- [Basic Usage](/1.x/guide/usage/basic-usage.md): Version 1.x centers on the YoutubePlayer component.
- [Player Controls](/1.x/guide/usage/player-controls.md): Version 1.x exposes player controls through a ref.
- [Handling Events](/1.x/guide/usage/handling-events.md): In 1.x, player events are callback props on YoutubePlayer. Wrap callbacks with useCallback for stable references and better performance.
- [Player Config](/1.x/guide/usage/player-config.md): Use playerVars to configure the initial YouTube playback environment. Common options include autoplay, controls, loop, muted, startTime, endTime, playsinline, rel, and origin.
- [Styling and Layout](/1.x/guide/usage/styling-and-layout.md): YoutubePlayer accepts sizing and platform-specific styling props. iframeStyle: Web onlywebViewStyle: iOS / Android onlywebViewProps: iOS / Android only
- [Inline HTML vs WebView](/1.x/guide/usage/inline-html-vs-webview.md): On iOS and Android, 1.x supports two render strategies.
- [Custom WebView Player](/1.x/guide/usage/custom-webview-player.md): Use @react-native-youtube-bridge/web when you need to host your own external player page. Then pass the hosted URL from the native app:
- [Metadata with oEmbed](/1.x/guide/usage/metadata-with-oembed.md): useYoutubeOEmbed fetches optional YouTube metadata for richer UI.
- [Errors and Troubleshooting](/1.x/guide/usage/errors-and-troubleshooting.md): This page exists so switching from the 2.x troubleshooting page to the 1.x docs does not land on a 404.
- [API Reference](/1.x/guide/usage/api-reference.md): This page summarizes the legacy 1.x component API and prevents version switching from the 2.x API reference from landing on a 404.
- [Migrate to 2.x](/1.x/guide/migration-from-1.x.md): Version 2.x replaces the old component/ref model with a hook-and-view model. [!tip] This page is a short migration note for readers inside the 1.x docs. For the full and latest migration guide, see the <a href="/guide/migration-from-1.x.html">2.x migration from 1.x guide</a>.

## Others

- [React Native Youtube Bridge 1.x](/1.x/index.md): [!warning] Version 1.x is the legacy API. New projects should use the 2.x hook-based docs. Redirecting to the 1.x overview.