@bluebillywig/react-native-bb-player 8.45.20 → 8.45.21

package/README.md

@@ -377,6 +377,34 @@ export function ChromecastPlayer() {
 
 > **Note:** Chromecast functionality is available on both iOS and Android platforms.
 
+## Example App
+
+The included example app (`example/`) demonstrates all SDK features. It's available on TestFlight (iOS) and as an APK download on each [GitHub release](https://github.com/bluebillywig/react-native-bb-player/releases).
+
+### Screens
+
+| Screen | Description |
+|--------|-------------|
+| **Simple Player** | Minimal player for performance testing |
+| **API Reference** | Interactive demo of all player methods: play, pause, seek, volume, fullscreen |
+| **Shorts** | Vertical video with swipe navigation, supports full and shelf display modes |
+| **Outstream Ads** | Standalone ad player with collapse/expand for article placements |
+| **Modal Player** | Native full-screen modal overlay with swipe-to-close (iOS) |
+
+### Running Locally
+
+```bash
+# Install dependencies
+npm ci && cd example && npm ci
+
+# iOS
+cd ios && pod install && cd ..
+npx react-native run-ios
+
+# Android
+npx react-native run-android
+```
+
 ## API Reference
 
 ### Component Props

package/ios/BBShortsView.swift

@@ -40,6 +40,7 @@ private enum LogLevel {
  */
 class BBShortsView: UIView, BBNativeShortsViewDelegate {
   private var shortsView: BBNativeShortsView?
+  private var navController: UINavigationController?
   private var hasSetup: Bool = false
 
   // MARK: - Props (set from React Native)
@@ -136,6 +137,17 @@ class BBShortsView: UIView, BBNativeShortsViewDelegate {
       return
     }
 
+    // Wrap in a UINavigationController so the native SDK can present
+    // shelf-mode modals (openShortsPlayerAsModal uses navigationController?.present).
+    // Hide the nav bar since we don't need visible navigation chrome.
+    let nav = UINavigationController(rootViewController: UIViewController())
+    nav.isNavigationBarHidden = true
+    nav.view.frame = bounds
+    nav.view.backgroundColor = .clear
+    viewController.addChild(nav)
+    nav.didMove(toParent: viewController)
+    self.navController = nav
+
     // Convert options to Swift dictionary
     var optionsDict: [String: Any]? = nil
     if let dict = options as? [String: Any], !dict.isEmpty {
@@ -143,8 +155,9 @@ class BBShortsView: UIView, BBNativeShortsViewDelegate {
     }
 
     // Create the shorts view using the factory method
+    // Pass the nav controller so the native SDK's shelf tap can present modals
     shortsView = BBNativeShorts.createShortsView(
-      uiViewController: viewController,
+      uiViewController: nav,
       frame: bounds,
       jsonUrl: jsonUrl,
       options: optionsDict
@@ -176,6 +189,10 @@ class BBShortsView: UIView, BBNativeShortsViewDelegate {
     shortsView?.destroy()
     shortsView?.removeFromSuperview()
     shortsView = nil
+    navController?.willMove(toParent: nil)
+    navController?.view.removeFromSuperview()
+    navController?.removeFromParent()
+    navController = nil
     hasSetup = false
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bluebillywig/react-native-bb-player",
-  "version": "8.45.20",
+  "version": "8.45.21",
   "description": "Blue Billywig Native Video Player for React Native - iOS AVPlayer and Android ExoPlayer integration",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",