expo-dev-menu 55.0.2 → 55.0.3

package/CHANGELOG.md

@@ -10,6 +10,23 @@
 
 ### 💡 Others
 
+## 55.0.3 — 2026-01-27
+
+### 🎉 New features
+
+- [iOS] Add delegate method to control visibility of "Open React Native dev menu" option. ([#42541](https://github.com/expo/expo/pull/42541) by [@alanjhughes](https://github.com/alanjhughes))
+- [iOS] Add action button. ([#42587](https://github.com/expo/expo/pull/42587) by [@alanjhughes](https://github.com/alanjhughes))
+
+### 🐛 Bug fixes
+
+- [iOS] Fix tvOS compilation errors in Source Map Explorer by excluding tvOS from unavailable SwiftUI APIs (`navigationBarTitleDisplayMode`, `listStyle(.insetGrouped)`, `Menu`) and adding proper availability checks. Refactored platform-specific modifiers to use `@ViewBuilder` instead of `AnyView` for better type preservation and performance. ([#42574](https://github.com/expo/expo/pull/42574) by [@OtavioStasiak](https://github.com/OtavioStasiak))
+- [Android] Fix dev menu not opening when pressing m key in CLI. ([#42566](https://github.com/expo/expo/pull/42566) by [@lukmccall](https://github.com/lukmccall))
+
+### 💡 Others
+
+- Make the Action Button always enabled on Quest. ([#42562](https://github.com/expo/expo/pull/42562) by [@behenate](https://github.com/behenate))
+- Moves connection info lower in the menu. ([#42568](https://github.com/expo/expo/pull/42568) and [#42569](https://github.com/expo/expo/pull/42569) by [@alanjhughes](https://github.com/alanjhughes))
+
 ## 55.0.2 — 2026-01-26
 
 ### 🎉 New features

package/android/build.gradle

@@ -12,7 +12,7 @@ apply plugin: 'expo-module-gradle-plugin'
 apply plugin: 'org.jetbrains.kotlin.plugin.compose'
 
 group = 'host.exp.exponent'
-version = '55.0.2'
+version = '55.0.3'
 
 def hasDevLauncher = findProject(":expo-dev-launcher") != null
 def configureInRelease = findProperty("expo.devmenu.configureInRelease") == "true"
@@ -29,7 +29,7 @@ android {
 
   defaultConfig {
     versionCode 10
-    versionName '55.0.2'
+    versionName '55.0.3'
   }
 
   buildTypes {

package/android/src/debug/java/expo/modules/devmenu/DevMenuPreferences.kt

@@ -3,6 +3,7 @@ package expo.modules.devmenu
 import android.app.Application
 import android.content.Context.MODE_PRIVATE
 import android.content.SharedPreferences
+import expo.modules.core.utilities.VRUtilities
 import expo.modules.devmenu.helpers.preferences
 
 private const val DEV_SETTINGS_PREFERENCES = "expo.modules.devmenu.sharedpreferences"
@@ -88,7 +89,6 @@ class DevMenuDefaultPreferences(
   override var isOnboardingFinished: Boolean
     by preferences(sharedPreferences, false)
 
-  // TODO: @behenate, on VR this value should be true by default
   override var showFab: Boolean
-    by preferences(sharedPreferences, false)
+    by preferences(sharedPreferences, VRUtilities.isQuest())
 }

package/android/src/debug/java/expo/modules/devmenu/compose/DevMenuState.kt

@@ -1,5 +1,6 @@
 package expo.modules.devmenu.compose
 
+import expo.modules.core.utilities.VRUtilities
 import expo.modules.devmenu.DevToolsSettings
 import org.json.JSONObject
 
@@ -8,7 +9,7 @@ data class DevMenuState(
   val isOpen: Boolean = false,
   val devToolsSettings: DevToolsSettings = DevToolsSettings(),
   val isOnboardingFinished: Boolean = false,
-  val showFab: Boolean = false,
+  val showFab: Boolean = VRUtilities.isQuest(),
   val customItems: List<CustomItem> = emptyList(),
   val hasGoHomeAction: Boolean = false,
   val isInPictureInPictureMode: Boolean = false

package/android/src/debug/java/expo/modules/devmenu/compose/ui/DevMenuScreen.kt

@@ -38,10 +38,6 @@ fun DevMenuScreen(
   }
 
   Column {
-    BundlerInfo(bundlerIp = appInfo.hostUrl)
-
-    Spacer(NewAppTheme.spacing.`2`)
-
     Row(
       horizontalArrangement = Arrangement.spacedBy(NewAppTheme.spacing.`2`),
       verticalAlignment = Alignment.CenterVertically
@@ -84,6 +80,10 @@ fun DevMenuScreen(
       }
     }
 
+    BundlerInfo(bundlerIp = appInfo.hostUrl)
+
+    Spacer(NewAppTheme.spacing.`5`)
+
     SystemSection(
       appInfo.appVersion,
       appInfo.sdkVersion,

package/android/src/debug/java/expo/modules/devmenu/compose/ui/ToolsSection.kt

@@ -3,6 +3,7 @@ package expo.modules.devmenu.compose.ui
 import androidx.compose.foundation.layout.Column
 import androidx.compose.runtime.Composable
 import androidx.compose.ui.unit.dp
+import expo.modules.core.utilities.VRUtilities
 import expo.modules.devmenu.DevToolsSettings
 import expo.modules.devmenu.compose.DevMenuAction
 import expo.modules.devmenu.compose.DevMenuActionHandler
@@ -111,30 +112,33 @@ fun ToolsSection(
 //        }
 //      )
 
-      Divider(thickness = 0.5.dp)
+      // Hide FAB toggle on Quest devices since FAB is always on there
+      if (!VRUtilities.isQuest()) {
+        Divider(thickness = 0.5.dp)
 
-      NewMenuButton(
-        withSurface = false,
-        icon = {
-          MenuIcons.Fab(
-            size = 20.dp,
-            tint = NewAppTheme.colors.icon.tertiary
-          )
-        },
-        content = {
-          NewText(
-            text = "Action button"
-          )
-        },
-        rightComponent = {
-          ToggleSwitch(
-            isToggled = showFab
-          )
-        },
-        onClick = {
-          onAction(DevMenuAction.ToggleFab)
-        }
-      )
+        NewMenuButton(
+          withSurface = false,
+          icon = {
+            MenuIcons.Fab(
+              size = 20.dp,
+              tint = NewAppTheme.colors.icon.tertiary
+            )
+          },
+          content = {
+            NewText(
+              text = "Action button"
+            )
+          },
+          rightComponent = {
+            ToggleSwitch(
+              isToggled = showFab
+            )
+          },
+          onClick = {
+            onAction(DevMenuAction.ToggleFab)
+          }
+        )
+      }
     }
   }
 }

package/android/src/debug/java/expo/modules/devmenu/websockets/DevMenuCommandHandlersProvider.kt

@@ -6,6 +6,10 @@ import com.facebook.react.packagerconnection.NotificationOnlyHandler
 import expo.modules.devmenu.devtools.DevMenuDevToolsDelegate
 import org.json.JSONObject
 import java.lang.ref.WeakReference
+import java.util.Date
+
+private object Mutex
+private var lastMessage = 0L
 
 class DevMenuCommandHandlersProvider(
   weakDevSupportManager: WeakReference<out DevSupportManager>
@@ -32,6 +36,8 @@ class DevMenuCommandHandlersProvider(
   }
 
   fun createCommandHandlers(): Map<String, NotificationOnlyHandler> {
+    lastMessage = Date().time
+
     return mapOf(
       "reload" to onReload,
       "devMenu" to onDevMenu,
@@ -42,7 +48,21 @@ class DevMenuCommandHandlersProvider(
   private fun createHandler(action: (params: Any?) -> Unit): NotificationOnlyHandler {
     return object : NotificationOnlyHandler() {
       override fun onNotification(params: Any?) {
-        action(params)
+        val currentTime = Date().time
+
+        synchronized(Mutex) {
+          val diff = currentTime - lastMessage
+          if (diff < 100) {
+            Log.w(
+              "DevMenu",
+              "Throttling incoming dev menu command. Time since last command: ${diff}ms"
+            )
+            return
+          }
+
+          action(params)
+          lastMessage = currentTime
+        }
       }
     }
   }

package/ios/DevMenuManager.swift

@@ -7,6 +7,27 @@ import CoreGraphics
 import CoreMedia
 import Combine
 
+/**
+ Configuration options for customizing the dev menu appearance.
+ Host apps (e.g., Expo Go) can set these to tailor the menu for their context.
+ The defaults match the standard dev menu behavior.
+ */
+@objc
+public class DevMenuConfiguration: NSObject {
+  /// Whether to show the debugging tip (e.g., "Debugging not working? Try manually reloading first.")
+  @objc public var showDebuggingTip: Bool = true
+
+  /// Whether to show the "Connected to:" host URL section
+  @objc public var showHostUrl: Bool = true
+
+  /// Whether to show the Fast Refresh toggle
+  @objc public var showFastRefresh: Bool = true
+
+  /// Custom title for the onboarding text. Use to replace "development builds" with e.g. "Expo Go".
+  /// When nil, the default "development builds" text is used.
+  @objc public var onboardingAppName: String?
+}
+
 class Dispatch {
   static func mainSync<T>(_ closure: () -> T) -> T {
     if Thread.isMainThread {
@@ -51,6 +72,8 @@ open class DevMenuManager: NSObject {
   var packagerConnectionHandler: DevMenuPackagerConnectionHandler?
   var canLaunchDevMenuOnStart = true
 
+  @objc public var configuration = DevMenuConfiguration()
+
   static public var wasInitilized = false
 
   /**
@@ -67,6 +90,13 @@ open class DevMenuManager: NSObject {
    */
   var window: DevMenuWindow?
 
+  #if !os(macOS) && !os(tvOS)
+  /**
+   The window that hosts the floating action button.
+   */
+  var fabWindow: DevMenuFABWindow?
+  #endif
+
   var currentScreen: String?
 
   weak var hostDelegate: DevMenuHostDelegate?
@@ -79,7 +109,10 @@ open class DevMenuManager: NSObject {
       if let currentBridge {
         DispatchQueue.main.async {
           self.disableRNDevMenuHoykeys(for: currentBridge)
+          self.updateFABVisibility()
         }
+      } else {
+        updateFABVisibility()
       }
     }
   }
@@ -250,7 +283,11 @@ open class DevMenuManager: NSObject {
   @objc
   @discardableResult
   public func hideMenu() -> Bool {
-    return setVisibility(false)
+    let result = setVisibility(false)
+    DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) { [weak self] in
+      self?.updateFABVisibility()
+    }
+    return result
   }
 
   /**
@@ -270,6 +307,15 @@ open class DevMenuManager: NSObject {
     return delegate.responds(to: #selector(DevMenuHostDelegate.devMenuNavigateHome))
   }
 
+  @objc
+  public var shouldShowReactNativeDevMenu: Bool {
+    guard let delegate = hostDelegate,
+      delegate.responds(to: #selector(DevMenuHostDelegate.devMenuShouldShowReactNativeDevMenu)) else {
+      return true
+    }
+    return delegate.devMenuShouldShowReactNativeDevMenu?() ?? true
+  }
+
   @objc
   public func navigateHome() {
     guard let delegate = hostDelegate,
@@ -369,9 +415,10 @@ open class DevMenuManager: NSObject {
 #if os(macOS)
         self.window?.makeKeyAndOrderFront(nil)
 #else
+        self.updateFABVisibility()
+
         if self.window?.windowScene == nil {
-          let keyWindowScene = UIApplication.shared.windows.first(where: { $0.isKeyWindow })?.windowScene
-          let windowScene = keyWindowScene ?? UIApplication.shared.connectedScenes
+          let windowScene = UIApplication.shared.connectedScenes
             .first(where: { $0.activationState == .foregroundActive }) as? UIWindowScene
           self.window?.windowScene = windowScene
         }
@@ -379,7 +426,12 @@ open class DevMenuManager: NSObject {
 #endif
       }
     } else {
-      DispatchQueue.main.async { self.window?.closeBottomSheet(nil) }
+      DispatchQueue.main.async {
+        self.window?.closeBottomSheet(nil)
+        DispatchQueue.main.asyncAfter(deadline: .now() + 0.3) {
+          self.updateFABVisibility()
+        }
+      }
     }
     return true
   }
@@ -457,4 +509,33 @@ open class DevMenuManager: NSObject {
     let devToolsDelegate = getDevToolsDelegate()
     devToolsDelegate?.toggleFastRefresh()
   }
+
+  #if !os(macOS) && !os(tvOS)
+  private func setupFABWindowIfNeeded(for windowScene: UIWindowScene) {
+    guard fabWindow == nil else { return }
+    fabWindow = DevMenuFABWindow(manager: self, windowScene: windowScene)
+  }
+
+  @objc
+  public func updateFABVisibility() {
+    DispatchQueue.main.async { [weak self] in
+      guard let self = self else { return }
+
+      if self.fabWindow == nil {
+        if let windowScene = UIApplication.shared.connectedScenes
+          .first(where: { $0.activationState == .foregroundActive }) as? UIWindowScene {
+          self.setupFABWindowIfNeeded(for: windowScene)
+        }
+      }
+
+      let shouldShow = DevMenuPreferences.showFloatingActionButton && !self.isVisible && self.currentBridge != nil
+      self.fabWindow?.setVisible(shouldShow, animated: true)
+    }
+  }
+  #else
+  @objc
+  public func updateFABVisibility() {
+    // FAB not available on macOS/tvOS
+  }
+  #endif
 }

package/ios/DevMenuWindow-default.swift

@@ -107,6 +107,7 @@ class DevMenuWindow: UIWindow, PresentationControllerDelegate {
       self.isDismissing = false
       self.isHidden = true
       self.backgroundColor = UIColor(white: 0, alpha: 0.4)
+      DevMenuManager.shared.updateFABVisibility()
       completion?()
     }
   }

package/ios/EXDevMenuDevSettings.swift

@@ -31,7 +31,7 @@ class EXDevMenuDevSettings: NSObject {
       devSettings["isHotLoadingEnabled"] = bridgeSettings.isHotLoadingEnabled
       devSettings["isPerfMonitorShown"] = bridgeSettings.isPerfMonitorShown
       devSettings["isHotLoadingAvailable"] = bridgeSettings.isHotLoadingAvailable
-      devSettings["isPerfMonitorAvailable"] = isPerfMonitorAvailable
+      devSettings["isPerfMonitorAvailable"] = isPerfMonitorAvailable && manager.currentManifest?.isDevelopmentMode() == true
       devSettings["isJSInspectorAvailable"] = bridgeSettings.isDeviceDebuggingAvailable
 
       let isElementInspectorAvailable = manager.currentManifest?.isDevelopmentMode()

package/ios/FAB/DevMenuFABView.swift

@@ -0,0 +1,195 @@
+// Copyright 2015-present 650 Industries. All rights reserved.
+
+#if !os(macOS) && !os(tvOS)
+
+import SwiftUI
+
+enum FABConstants {
+  static let iconSize: CGFloat = 44
+  static let margin: CGFloat = 16
+  static let dragThreshold: CGFloat = 40
+  static let momentumFactor: CGFloat = 0.35
+  static let labelDismissDelay: TimeInterval = 10
+
+  static let snapAnimation: Animation = .spring(
+    response: 0.6,
+    dampingFraction: 0.7,
+    blendDuration: 0
+  )
+}
+
+struct FabPill: View {
+  @Binding var isPressed: Bool
+  @State private var showLabel = true
+
+  var body: some View {
+    VStack(spacing: 4) {
+      Image(systemName: "gearshape.fill")
+        .font(.system(size: 20))
+        .foregroundStyle(.white)
+        .frame(width: FABConstants.iconSize, height: FABConstants.iconSize)
+        .background(Color.blue, in: Circle())
+        .overlay(
+          Circle()
+            .stroke(Color.blue.opacity(0.5), lineWidth: 4)
+            .frame(width: FABConstants.iconSize + 4, height: FABConstants.iconSize + 4)
+        )
+        .opacity(isPressed ? 0.8 : 1.0)
+        .scaleEffect(isPressed ? 0.9 : 1.0)
+        .animation(.easeInOut(duration: 0.1), value: isPressed)
+
+      if showLabel {
+        Text("Dev tools")
+          .font(.system(size: 11, weight: .medium))
+          .foregroundStyle(.secondary)
+          .fixedSize()
+          .padding(.horizontal, 8)
+          .padding(.vertical, 3)
+          .background(.regularMaterial, in: Capsule())
+          .transition(.opacity.combined(with: .scale(scale: 0.8)))
+      }
+    }
+    .task {
+      try? await Task.sleep(nanoseconds: UInt64(1_000_000_000 * FABConstants.labelDismissDelay))
+      await MainActor.run {
+        withAnimation(.easeOut(duration: 0.3)) {
+          showLabel = false
+        }
+      }
+    }
+  }
+}
+
+struct DevMenuFABView: View {
+  let onOpenMenu: () -> Void
+  let onFrameChange: (CGRect) -> Void
+
+  private let fabSize = CGSize(width: 72, height: FABConstants.iconSize + 24)
+
+  @State private var position: CGPoint = .zero
+  @State private var isDragging = false
+  @State private var isPressed = false
+  @State private var dragStartPosition: CGPoint = .zero
+
+  private var currentFrame: CGRect {
+    CGRect(origin: position, size: fabSize)
+  }
+
+  var body: some View {
+    GeometryReader { geometry in
+      let safeArea = geometry.safeAreaInsets
+      FabPill(isPressed: $isPressed)
+        .frame(width: fabSize.width, height: fabSize.height)
+        .position(x: currentFrame.midX, y: currentFrame.midY)
+        .gesture(dragGesture(bounds: geometry.size, safeArea: safeArea))
+        .onAppear {
+          let initialPos = defaultPosition(bounds: geometry.size, safeArea: safeArea)
+          position = initialPos
+          onFrameChange(CGRect(origin: initialPos, size: fabSize))
+        }
+        .onChange(of: geometry.size) { newSize in
+          let newPos = snapToEdge(
+            from: position,
+            velocity: .zero,
+            bounds: newSize,
+            safeArea: safeArea
+          )
+          position = newPos
+          onFrameChange(CGRect(origin: newPos, size: fabSize))
+        }
+        .animation(isDragging ? nil : FABConstants.snapAnimation, value: position)
+    }
+    .ignoresSafeArea()
+  }
+
+  private func dragGesture(bounds: CGSize, safeArea: EdgeInsets) -> some Gesture {
+    DragGesture(minimumDistance: 0)
+      .onChanged { value in
+        if !isPressed {
+          isPressed = true
+        }
+        if !isDragging && value.translation.magnitude > FABConstants.dragThreshold {
+          isDragging = true
+          isPressed = false
+          dragStartPosition = position
+        }
+        if isDragging {
+          position = CGPoint(
+            x: dragStartPosition.x + value.translation.width,
+            y: dragStartPosition.y + value.translation.height
+          )
+          onFrameChange(currentFrame)
+        }
+      }
+      .onEnded { value in
+        isPressed = false
+        let dragDistance = value.translation.magnitude
+
+        if dragDistance < FABConstants.dragThreshold {
+          isDragging = false
+          onOpenMenu()
+        } else {
+          let velocity = CGPoint(
+            x: value.predictedEndLocation.x - value.location.x,
+            y: value.predictedEndLocation.y - value.location.y
+          )
+
+          let newPos = snapToEdge(
+            from: position,
+            velocity: velocity,
+            bounds: bounds,
+            safeArea: safeArea
+          )
+
+          DispatchQueue.main.async {
+            isDragging = false
+            position = newPos
+            onFrameChange(CGRect(origin: newPos, size: fabSize))
+          }
+        }
+      }
+  }
+
+  private func defaultPosition(bounds: CGSize, safeArea: EdgeInsets) -> CGPoint {
+    CGPoint(
+      x: bounds.width - fabSize.width - FABConstants.margin,
+      y: (bounds.height / 2) - fabSize.height
+    )
+  }
+
+  private func snapToEdge(
+    from point: CGPoint,
+    velocity: CGPoint,
+    bounds: CGSize,
+    safeArea: EdgeInsets
+  ) -> CGPoint {
+    let margin = FABConstants.margin
+    let momentumX = velocity.x * FABConstants.momentumFactor
+    let momentumY = velocity.y * FABConstants.momentumFactor
+
+    let estimatedCenterX = point.x + self.fabSize.width / 2 + momentumX
+    let targetX: CGFloat = estimatedCenterX < bounds.width / 2
+      ? margin
+    : bounds.width - self.fabSize.width - margin
+
+    let minY = margin + safeArea.top
+    let maxY = bounds.height - self.fabSize.height - margin - safeArea.bottom
+    let targetY = (point.y + momentumY).clamped(to: minY...maxY)
+
+    return CGPoint(x: targetX, y: targetY)
+  }
+}
+
+private extension CGSize {
+  var magnitude: CGFloat {
+    sqrt(width * width + height * height)
+  }
+}
+
+private extension Comparable {
+  func clamped(to range: ClosedRange<Self>) -> Self {
+    min(max(self, range.lowerBound), range.upperBound)
+  }
+}
+
+#endif

package/ios/FAB/DevMenuFABWindow.swift

@@ -0,0 +1,105 @@
+// Copyright 2015-present 650 Industries. All rights reserved.
+
+#if !os(macOS) && !os(tvOS)
+
+import UIKit
+import SwiftUI
+
+/// A passthrough window that hosts the floating action button.
+class DevMenuFABWindow: UIWindow {
+  private weak var manager: DevMenuManager?
+  private var hostingController: UIHostingController<DevMenuFABView>?
+  var fabFrame: CGRect = .zero
+
+  init(manager: DevMenuManager, windowScene: UIWindowScene) {
+    self.manager = manager
+    super.init(windowScene: windowScene)
+    setupWindow()
+  }
+
+  @available(*, unavailable)
+  required init?(coder: NSCoder) {
+    fatalError("init(coder:) has not been implemented")
+  }
+
+  private func setupWindow() {
+    windowLevel = UIWindow.Level.statusBar - 1
+    backgroundColor = .clear
+    isHidden = true
+    alpha = 0
+
+    let fabView = DevMenuFABView(
+      onOpenMenu: { [weak self] in
+        self?.manager?.openMenu()
+      },
+      onFrameChange: { [weak self] frame in
+        self?.fabFrame = frame
+      }
+    )
+
+    let hostingController = UIHostingController(rootView: fabView)
+    hostingController.view.backgroundColor = .clear
+    self.hostingController = hostingController
+    rootViewController = hostingController
+  }
+
+  private var edgeTranslation: CGAffineTransform {
+    let screenWidth = windowScene?.screen.bounds.width ?? UIScreen.main.bounds.width
+    let isOnRight = fabFrame == .zero || fabFrame.midX > (screenWidth / 2)
+    let dx: CGFloat = isOnRight ? 60 : -60
+    return CGAffineTransform(translationX: dx, y: 0)
+  }
+
+  func setVisible(_ visible: Bool, animated: Bool = true) {
+    if visible {
+      isHidden = false
+      if animated {
+        alpha = 0
+        transform = edgeTranslation
+        UIView.animate(
+          withDuration: 0.5,
+          delay: 0,
+          usingSpringWithDamping: 0.6,
+          initialSpringVelocity: 0.8,
+          options: .curveEaseOut
+        ) {
+          self.alpha = 1
+          self.transform = .identity
+        }
+      } else {
+        alpha = 1
+        transform = .identity
+      }
+    } else {
+      if animated {
+        UIView.animate(
+          withDuration: 0.4,
+          delay: 0,
+          usingSpringWithDamping: 0.6,
+          initialSpringVelocity: 0.8,
+          options: .curveEaseIn
+        ) {
+          self.alpha = 0
+          self.transform = self.edgeTranslation
+        } completion: { _ in
+          self.isHidden = true
+          self.transform = .identity
+        }
+      } else {
+        alpha = 0
+        isHidden = true
+      }
+    }
+  }
+
+  override func hitTest(_ point: CGPoint, with event: UIEvent?) -> UIView? {
+    let hitArea = fabFrame.insetBy(dx: -10, dy: -10)
+    if hitArea.contains(point) {
+      return super.hitTest(point, with: event)
+    }
+
+    return nil
+  }
+}
+
+#endif

package/ios/Modules/DevMenuPreferences.swift

@@ -6,6 +6,7 @@ let touchGestureEnabledKey = "EXDevMenuTouchGestureEnabled"
 let keyCommandsEnabledKey = "EXDevMenuKeyCommandsEnabled"
 let showsAtLaunchKey = "EXDevMenuShowsAtLaunch"
 let isOnboardingFinishedKey = "EXDevMenuIsOnboardingFinished"
+let showFloatingActionButtonKey = "EXDevMenuShowFloatingActionButton"
 
 public class DevMenuPreferences: Module {
   public func definition() -> ModuleDefinition {
@@ -31,7 +32,8 @@ public class DevMenuPreferences: Module {
       touchGestureEnabledKey: false,
       keyCommandsEnabledKey: true,
       showsAtLaunchKey: false,
-      isOnboardingFinishedKey: true
+      isOnboardingFinishedKey: true,
+      showFloatingActionButtonKey: false
     ])
     #else
     UserDefaults.standard.register(defaults: [
@@ -39,7 +41,8 @@ public class DevMenuPreferences: Module {
       touchGestureEnabledKey: true,
       keyCommandsEnabledKey: true,
       showsAtLaunchKey: false,
-      isOnboardingFinishedKey: false
+      isOnboardingFinishedKey: false,
+      showFloatingActionButtonKey: false
     ])
     #endif
 
@@ -129,6 +132,16 @@ public class DevMenuPreferences: Module {
     }
   }
 
+  public static var showFloatingActionButton: Bool {
+    get {
+      return boolForKey(showFloatingActionButtonKey)
+    }
+    set {
+      setBool(newValue, forKey: showFloatingActionButtonKey)
+      DevMenuManager.shared.updateFABVisibility()
+    }
+  }
+
   /**
    Serializes settings into a dictionary so they can be passed through the bridge.
    */
@@ -138,7 +151,8 @@ public class DevMenuPreferences: Module {
       "touchGestureEnabled": DevMenuPreferences.touchGestureEnabled,
       "keyCommandsEnabled": DevMenuPreferences.keyCommandsEnabled,
       "showsAtLaunch": DevMenuPreferences.showsAtLaunch,
-      "isOnboardingFinished": DevMenuPreferences.isOnboardingFinished
+      "isOnboardingFinished": DevMenuPreferences.isOnboardingFinished,
+      "showFloatingActionButton": DevMenuPreferences.showFloatingActionButton
     ]
   }
 
@@ -155,6 +169,9 @@ public class DevMenuPreferences: Module {
     if let showsAtLaunch = settings["showsAtLaunch"] as? Bool {
       DevMenuPreferences.showsAtLaunch = showsAtLaunch
     }
+    if let showFloatingActionButton = settings["showFloatingActionButton"] as? Bool {
+      DevMenuPreferences.showFloatingActionButton = showFloatingActionButton
+    }
   }
 
   @objc static func toggleMenu() {

package/ios/SwiftUI/DevMenuAppInfo.swift

@@ -43,6 +43,7 @@ struct DevMenuAppInfo: View {
           .disabled(viewModel.clipboardMessage != nil)
         }
       }
+      .padding(.horizontal)
       .background(Color.expoSystemBackground)
       .cornerRadius(18)
     }

package/ios/SwiftUI/DevMenuDeveloperTools.swift

@@ -38,15 +38,28 @@ struct DevMenuDeveloperTools: View {
           )
         }
 
+        if viewModel.configuration.showFastRefresh {
+          Divider()
+
+          DevMenuToggleButton(
+            title: "Fast refresh",
+            icon: "figure.run",
+            isEnabled: viewModel.devSettings?.isHotLoadingEnabled ?? false,
+            action: viewModel.toggleFastRefresh,
+            disabled: !(viewModel.devSettings?.isHotLoadingAvailable ?? true)
+          )
+        }
+
+        #if !os(tvOS) && !os(macOS)
         Divider()
 
         DevMenuToggleButton(
-          title: "Fast refresh",
-          icon: "figure.run",
-          isEnabled: viewModel.devSettings?.isHotLoadingEnabled ?? false,
-          action: viewModel.toggleFastRefresh,
-          disabled: !(viewModel.devSettings?.isHotLoadingAvailable ?? true)
+          title: "Action button",
+          icon: "hand.tap",
+          isEnabled: viewModel.showFloatingActionButton,
+          action: viewModel.toggleFloatingActionButton
         )
+        #endif
 
         Divider()
 

package/ios/SwiftUI/DevMenuMainView.swift

@@ -6,21 +6,11 @@ struct DevMenuMainView: View {
   var body: some View {
     ScrollView {
       VStack(spacing: 32) {
-        VStack {
-          if let hostUrl = viewModel.appInfo?.hostUrl {
-            HostUrl(
-              hostUrl: hostUrl,
-              onCopy: viewModel.copyToClipboard,
-              copiedMessage: viewModel.hostUrlCopiedMessage
-            )
-          }
-
-          DevMenuActions(
-            canNavigateHome: viewModel.canNavigateHome,
-            onReload: viewModel.reload,
-            onGoHome: viewModel.goHome
-          )
-        }
+        DevMenuActions(
+          canNavigateHome: viewModel.canNavigateHome,
+          onReload: viewModel.reload,
+          onGoHome: viewModel.goHome
+        )
 
         if !viewModel.registeredCallbacks.isEmpty {
           CustomItems(
@@ -31,13 +21,23 @@ struct DevMenuMainView: View {
 
         DevMenuDeveloperTools()
 
-        if viewModel.appInfo?.engine == "Hermes" {
+        if viewModel.configuration.showDebuggingTip && viewModel.appInfo?.engine == "Hermes" {
           HermesDebuggerTip()
         }
 
+        if viewModel.configuration.showHostUrl, let hostUrl = viewModel.appInfo?.hostUrl {
+          HostUrl(
+            hostUrl: hostUrl,
+            onCopy: viewModel.copyToClipboard,
+            copiedMessage: viewModel.hostUrlCopiedMessage
+          )
+        }
+
         DevMenuAppInfo()
 
-        DevMenuRNDevMenu(onOpenRNDevMenu: viewModel.openRNDevMenu)
+        if viewModel.shouldShowReactNativeDevMenu {
+          DevMenuRNDevMenu(onOpenRNDevMenu: viewModel.openRNDevMenu)
+        }
       }
       .padding()
     }
@@ -45,6 +45,7 @@ struct DevMenuMainView: View {
     .navigationTitle("Dev Menu")
 #if !os(macOS)
     .navigationBarHidden(true)
+    .navigationBarTitleDisplayMode(.inline)
 #endif
   }
 }

package/ios/SwiftUI/DevMenuOnboardingView.swift

@@ -2,6 +2,7 @@ import SwiftUI
 
 struct DevMenuOnboardingView: View {
   let onFinish: () -> Void
+  var appName: String = "development builds"
   @State private var isVisible = true
 
   var body: some View {
@@ -16,7 +17,7 @@ struct DevMenuOnboardingView: View {
   private var onboardingOverlay: some View {
     VStack(spacing: 24) {
       VStack(spacing: 16) {
-        Text("This is the developer menu. It gives you access to useful tools in your development builds.")
+        Text("This is the developer menu. It gives you access to useful tools in \(appName).")
           .frame(maxWidth: .infinity, alignment: .leading)
           .font(.callout)
 

package/ios/SwiftUI/DevMenuRootView.swift

@@ -17,7 +17,10 @@ struct DevMenuRootView: View {
 
         #if !os(tvOS)
         if !viewModel.isOnboardingFinished {
-          DevMenuOnboardingView(onFinish: viewModel.finishOnboarding)
+          DevMenuOnboardingView(
+            onFinish: viewModel.finishOnboarding,
+            appName: viewModel.configuration.onboardingAppName ?? "your development builds"
+          )
         }
         #endif
       }

package/ios/SwiftUI/DevMenuViewModel.swift

@@ -12,6 +12,7 @@ class DevMenuViewModel: ObservableObject {
   @Published var clipboardMessage: String?
   @Published var hostUrlCopiedMessage: String?
   @Published var isOnboardingFinished: Bool = true
+  @Published var showFloatingActionButton: Bool = false
 
   private let devMenuManager = DevMenuManager.shared
   private var cancellables = Set<AnyCancellable>()
@@ -27,6 +28,7 @@ class DevMenuViewModel: ObservableObject {
     loadAppInfo()
     loadDevSettings()
     loadRegisteredCallbacks()
+    loadFloatingActionButtonState()
   }
 
   private func loadAppInfo() {
@@ -165,6 +167,14 @@ class DevMenuViewModel: ObservableObject {
     return devMenuManager.canNavigateHome
   }
 
+  var shouldShowReactNativeDevMenu: Bool {
+    return devMenuManager.shouldShowReactNativeDevMenu
+  }
+
+  var configuration: DevMenuConfiguration {
+    return devMenuManager.configuration
+  }
+
   private func checkOnboardingStatus() {
     isOnboardingFinished = devMenuManager.isOnboardingFinished
   }
@@ -174,6 +184,15 @@ class DevMenuViewModel: ObservableObject {
     isOnboardingFinished = true
   }
 
+  private func loadFloatingActionButtonState() {
+    showFloatingActionButton = DevMenuPreferences.showFloatingActionButton
+  }
+
+  func toggleFloatingActionButton() {
+    showFloatingActionButton.toggle()
+    DevMenuPreferences.showFloatingActionButton = showFloatingActionButton
+  }
+
   private func observeRegisteredCallbacks() {
     devMenuManager.callbacksPublisher
       .map { $0.map { $0.name } }
@@ -186,6 +205,7 @@ class DevMenuViewModel: ObservableObject {
       .receive(on: DispatchQueue.main)
       .sink { [weak self] _ in
         self?.loadAppInfo()
+        self?.loadDevSettings()
       }
       .store(in: &cancellables)
   }

package/ios/SwiftUI/HeaderView.swift

@@ -11,7 +11,7 @@ typealias PlatformImage = UIImage
 
 struct HeaderView: View {
   @EnvironmentObject var viewModel: DevMenuViewModel
-  @State private var appIcon: PlatformImage? = nil
+  @State private var appIcon: PlatformImage?
 
   var body: some View {
     HStack(spacing: 12) {

package/ios/SwiftUI/SourceMapExplorerView.swift

@@ -28,8 +28,9 @@ struct SourceMapExplorerView: View {
       }
     }
     .navigationTitle("Source Code Explorer")
-#if !os(macOS)
+#if !os(macOS) && !os(tvOS)
     .navigationBarTitleDisplayMode(.inline)
+    .navigationBarHidden(false)
 #endif
     .searchable(text: $viewModel.searchText, placement: .automatic, prompt: "Search files")
     .task {
@@ -64,7 +65,9 @@ struct SourceMapExplorerView: View {
       Button("Retry") {
         Task { await viewModel.loadSourceMap() }
       }
+      #if !os(tvOS)
       .buttonStyle(.borderedProminent)
+      #endif
     }
     .padding()
     .frame(maxWidth: .infinity, maxHeight: .infinity)
@@ -85,43 +88,60 @@ struct FolderListView: View {
           .foregroundColor(.secondary)
       } else {
         ForEach(nodes) { node in
-          if node.isDirectory {
-            NavigationLink(destination: FolderListView(
-              title: node.name,
-              nodes: node.children,
-              sourceMap: sourceMap,
-              stats: nil,
-              isSearching: false
-            )) {
-              FileRow(node: node, showPath: isSearching)
-            }
-          } else {
-            NavigationLink(destination: CodeFileView(node: node, sourceMap: sourceMap)) {
-              FileRow(node: node, showPath: isSearching)
-            }
+          NavigationLink(destination: destinationView(for: node)) {
+            FileRow(node: node, showPath: isSearching)
           }
         }
       }
     }
-#if !os(macOS)
+#if !os(macOS) && !os(tvOS)
     .listStyle(.insetGrouped)
+#elseif os(tvOS)
+    .listStyle(.plain)
 #endif
     .navigationTitle(isSearching ? "Search Results" : title)
-#if !os(macOS)
+#if !os(macOS) && !os(tvOS)
     .navigationBarTitleDisplayMode(.inline)
+#endif
     .toolbar {
       ToolbarItem(placement: .navigationBarTrailing) {
         if let stats = stats {
+#if os(tvOS)
+          if #available(tvOS 17.0, *) {
+            Menu {
+              Label("\(stats.files) files", systemImage: "doc.on.doc")
+              Label(stats.totalSize, systemImage: "internaldrive")
+            } label: {
+              Image(systemName: "info.circle")
+            }
+          }
+          // Menu not available on tvOS < 17.0, toolbar item is hidden
+#else
           Menu {
             Label("\(stats.files) files", systemImage: "doc.on.doc")
             Label(stats.totalSize, systemImage: "internaldrive")
           } label: {
             Image(systemName: "info.circle")
           }
+#endif
         }
       }
     }
-#endif
+  }
+
+  @ViewBuilder
+  private func destinationView(for node: FileTreeNode) -> some View {
+    if node.isDirectory {
+      FolderListView(
+        title: node.name,
+        nodes: node.children,
+        sourceMap: sourceMap,
+        stats: nil,
+        isSearching: false
+      )
+    } else {
+      CodeFileView(node: node, sourceMap: sourceMap)
+    }
   }
 }
 
@@ -183,8 +203,10 @@ struct CodeFileView: View {
   let sourceMap: SourceMap?
   @Environment(\.colorScheme) private var colorScheme
   @State private var highlightedLines: [AttributedString]?
+  @State private var isEditing = false
+  @State private var displayContent: String = ""
 
-  private var content: String {
+  private var originalContent: String {
     guard let contentIndex = node.contentIndex,
           let sourceMap,
           let sourcesContent = sourceMap.sourcesContent,
@@ -196,7 +218,7 @@ struct CodeFileView: View {
   }
 
   private var lines: [String] {
-    content.components(separatedBy: "\n")
+    displayContent.components(separatedBy: "\n")
   }
 
   private var theme: SyntaxHighlighter.Theme {
@@ -209,35 +231,83 @@ struct CodeFileView: View {
   }
 
   var body: some View {
-    GeometryReader { geometry in
-      ScrollView(.vertical) {
-        ScrollView(.horizontal, showsIndicators: false) {
-          HStack(alignment: .top, spacing: 0) {
-            LineNumbersColumn(lines: lines, theme: theme, lineNumberWidth: lineNumberWidth)
-            CodeColumn(lines: lines, highlightedLines: highlightedLines, theme: theme)
-          }
-          .frame(minWidth: geometry.size.width, alignment: .leading)
-        }
+    Group {
+      if isEditing {
+        editingView()
+      } else {
+        readOnlyView()
       }
     }
     .background(theme.background)
     .navigationTitle(node.name)
-#if !os(macOS)
+#if !os(macOS) && !os(tvOS)
     .navigationBarTitleDisplayMode(.inline)
+    .toolbar {
+      ToolbarItem(placement: .navigationBarTrailing) {
+        Button(isEditing ? "Done" : "Edit") {
+          if isEditing {
+            isEditing = false
+            Task {
+              highlightedLines = await SyntaxHighlighter.highlightLines(lines, theme: theme)
+            }
+          } else {
+            isEditing = true
+          }
+        }
+      }
+    }
 #endif
+    .onAppear {
+      if displayContent.isEmpty {
+        displayContent = originalContent
+      }
+    }
     .task(id: colorScheme) {
       highlightedLines = await SyntaxHighlighter.highlightLines(lines, theme: theme)
     }
   }
+
+  private func readOnlyView() -> some View {
+    ScrollView(.vertical) {
+      ScrollView(.horizontal, showsIndicators: false) {
+        HStack(alignment: .top, spacing: 0) {
+          LineNumbersColumn(lines: lines, theme: theme, lineNumberWidth: lineNumberWidth)
+          CodeColumn(lines: lines, highlightedLines: highlightedLines, theme: theme)
+        }
+      }
+    }
+  }
+
+  private func editingView() -> some View {
+    TextEditor(text: $displayContent)
+      .font(.system(size: 13, weight: .regular, design: .monospaced))
+      #if os(iOS) || os(tvOS)
+      .textInputAutocapitalization(.never)
+      #endif
+      .autocorrectionDisabled()
+      .modifier(ScrollContentBackgroundModifier())
+      .background(theme.background)
+      .foregroundColor(theme.plain)
+  }
+}
+
+private struct ScrollContentBackgroundModifier: ViewModifier {
+  func body(content: Content) -> some View {
+    if #available(iOS 16.0, tvOS 16.0, *) {
+      content.scrollContentBackground(.hidden)
+    } else {
+      content
+    }
+  }
 }
 
 struct LineNumbersColumn: View {
   let lines: [String]
   let theme: SyntaxHighlighter.Theme
   let lineNumberWidth: CGFloat
-  
+
   var body: some View {
-    LazyVStack(alignment: .trailing, spacing: 0) {
+    VStack(alignment: .trailing, spacing: 0) {
       ForEach(0..<lines.count, id: \.self) { index in
         Text("\(index + 1)")
           .font(.system(size: 13, weight: .regular, design: .monospaced))
@@ -255,9 +325,9 @@ struct CodeColumn: View {
   let lines: [String]
   let highlightedLines: [AttributedString]?
   let theme: SyntaxHighlighter.Theme
-  
+
   var body: some View {
-    LazyVStack(alignment: .leading, spacing: 0) {
+    VStack(alignment: .leading, spacing: 0) {
       ForEach(0..<lines.count, id: \.self) { index in
         if let highlightedLines, index < highlightedLines.count {
           Text(highlightedLines[index])
@@ -271,13 +341,8 @@ struct CodeColumn: View {
         }
       }
     }
+    .fixedSize(horizontal: true, vertical: false)
     .padding(.vertical, 12)
     .padding(.trailing, 16)
   }
 }
-
-#Preview {
-  NavigationView {
-    SourceMapExplorerView()
-  }
-}

package/ios/SwiftUI/SourceMapService.swift

@@ -184,7 +184,7 @@ class SourceMapService {
   private func extractInlineSourceMap(from bundleContent: String) throws -> SourceMap {
     let patterns = [
       "//# sourceMappingURL=data:application/json;charset=utf-8;base64,",
-      "//# sourceMappingURL=data:application/json;base64,",
+      "//# sourceMappingURL=data:application/json;base64,"
     ]
 
     for pattern in patterns {
@@ -234,7 +234,14 @@ class SourceMapService {
 
     let nodes = root.children.values.map { convertToNode($0) }
     let sorted = sortNodes(nodes)
-    return collapseSingleChildFolders(sorted)
+    let collapsed = collapseSingleChildFolders(sorted)
+
+    let directories = collapsed.filter { $0.isDirectory }
+    if directories.count == 1, let mainDir = directories.first {
+      return mainDir.children
+    }
+
+    return collapsed
   }
 
   private func convertToNode(_ builder: Node) -> FileTreeNode {
@@ -255,7 +262,7 @@ class SourceMapService {
       while current.isDirectory && current.children.count == 1 && current.children[0].isDirectory {
         let child = current.children[0]
         current = FileTreeNode(
-          name: "\(current.name)/\(child.name)",
+          name: child.name,
           path: child.path,
           isDirectory: true,
           children: child.children,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-dev-menu",
-  "version": "55.0.2",
+  "version": "55.0.3",
   "description": "Expo/React Native module with the developer menu.",
   "main": "build/DevMenu.js",
   "types": "build/DevMenu.d.ts",
@@ -33,7 +33,7 @@
   "license": "MIT",
   "homepage": "https://docs.expo.dev",
   "dependencies": {
-    "expo-dev-menu-interface": "55.0.0"
+    "expo-dev-menu-interface": "55.0.1"
   },
   "devDependencies": {
     "@babel/preset-typescript": "^7.7.4",
@@ -47,5 +47,5 @@
   "peerDependencies": {
     "expo": "*"
   },
-  "gitHead": "7d7f6762fc6907c27a329953c682134a84410dea"
+  "gitHead": "220594d473a3100248087151004ae4acb7282d5f"
 }