expo-dev-menu 56.0.16 → 56.0.18

package/CHANGELOG.md

@@ -10,6 +10,17 @@
 
 ### 💡 Others
 
+## 56.0.18 — 2026-07-01
+
+### 🐛 Bug fixes
+
+- [Android] Restore the "Open React Native dev menu" entry in the dev menu's Tools section (regressed in [#38759](https://github.com/expo/expo/pull/38759)). ([#47047](https://github.com/expo/expo/pull/47047) by [@lindboe](https://github.com/lindboe))
+- [Android] Re-enable the Fast Refresh toggle in the dev menu's Tools section. ([#47136](https://github.com/expo/expo/pull/47136) by [@lukmccall](https://github.com/lukmccall))
+
+## 56.0.17 — 2026-06-10
+
+_This version does not introduce any user-facing changes._
+
 ## 56.0.16 — 2026-05-29
 
 _This version does not introduce any user-facing changes._

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 = '56.0.16'
+version = '56.0.18'
 
 def hasDevLauncher = findProject(":expo-dev-launcher") != null
 def configureInRelease = findProperty("expo.devmenu.configureInRelease") == "true"
@@ -29,7 +29,7 @@ android {
 
   defaultConfig {
     versionCode 10
-    versionName '56.0.16'
+    versionName '56.0.18'
   }
 
   buildTypes {

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

@@ -122,6 +122,22 @@ object MenuIcons {
     )
   }
 
+  @Composable
+  fun Gear(
+    size: Dp,
+    tint: Color,
+    modifier: Modifier = Modifier
+  ) {
+    Icon(
+      painter = painterResource(R.drawable.gear_fill),
+      contentDescription = "React Native dev menu",
+      tint = tint,
+      modifier = Modifier
+        .size(size)
+        .then(modifier)
+    )
+  }
+
   @Composable
   fun Refresh(
     size: Dp,

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

@@ -86,31 +86,50 @@ fun ToolsSection(
         }
       )
 
-      // TODO(@lukmccall): Re-enable when toggling fast refresh is not longer crashing app
-//      Divider(thickness = 0.5.dp)
-//
-//      NewMenuButton(
-//        withSurface = false,
-//        icon = {
-//          MenuIcons.Refresh(
-//            size = 20.dp,
-//            tint = NewAppTheme.colors.icon.tertiary
-//          )
-//        },
-//        content = {
-//          NewText(
-//            text = "Fast Refresh"
-//          )
-//        },
-//        rightComponent = {
-//          ToggleSwitch(
-//            isToggled = devToolsSettings.isHotLoadingEnabled
-//          )
-//        },
-//        onClick = {
-//          onAction(DevMenuAction.ToggleFastRefresh(!devToolsSettings.isHotLoadingEnabled))
-//        }
-//      )
+      Divider(thickness = 0.5.dp)
+
+      NewMenuButton(
+        withSurface = false,
+        icon = {
+          MenuIcons.Gear(
+            size = 20.dp,
+            tint = NewAppTheme.colors.icon.tertiary
+          )
+        },
+        content = {
+          NewText(
+            text = "Open React Native dev menu"
+          )
+        },
+        onClick = {
+          onAction(DevMenuAction.OpenReactNativeDevMenu)
+        }
+      )
+
+      Divider(thickness = 0.5.dp)
+
+      NewMenuButton(
+        withSurface = false,
+        icon = {
+          MenuIcons.Refresh(
+            size = 20.dp,
+            tint = NewAppTheme.colors.icon.tertiary
+          )
+        },
+        content = {
+          NewText(
+            text = "Fast Refresh"
+          )
+        },
+        rightComponent = {
+          ToggleSwitch(
+            isToggled = devToolsSettings.isHotLoadingEnabled
+          )
+        },
+        onClick = {
+          onAction(DevMenuAction.ToggleFastRefresh(!devToolsSettings.isHotLoadingEnabled))
+        }
+      )
 
       // Hide FAB toggle on Quest devices since FAB is always on there
       if (!VRUtilities.isQuest()) {

package/android/src/debug/java/expo/modules/devmenu/devtools/DevMenuDevToolsDelegate.kt

@@ -19,6 +19,7 @@ import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.GlobalScope
 import kotlinx.coroutines.launch
 import java.lang.ref.WeakReference
+import java.lang.reflect.Proxy
 
 class DevMenuDevToolsDelegate(
   private val weakDevSupportManager: WeakReference<out DevSupportManager>
@@ -77,9 +78,9 @@ class DevMenuDevToolsDelegate(
     internalSettings.isHotModuleReplacementEnabled = nextEnabled
 
     if (nextEnabled) {
-      reactContext?.getJSModule(HMRClient::class.java)?.enable()
+      reactContext?.callHMRClientMethod("enable")
     } else {
-      reactContext?.getJSModule(HMRClient::class.java)?.disable()
+      reactContext?.callHMRClientMethod("disable")
     }
 
     if (nextEnabled && !internalSettings.isJSDevModeEnabled) {
@@ -88,6 +89,33 @@ class DevMenuDevToolsDelegate(
     }
   }
 
+  /**
+   * Invokes a no-argument [HMRClient] method (`enable`/`disable`) without tripping a bug in React
+   * Native's bridgeless JS module proxy.
+   *
+   * When a zero-argument method is invoked through the proxy returned by [ReactContext.getJSModule],
+   * the JDK passes a `null` args array to the invocation handler. In bridgeless mode that handler
+   * (`BridgelessReactContext.BridgelessJSModuleInvocationHandler`) declares the parameter non-null,
+   * so Kotlin's null check throws a [NullPointerException] before the call ever reaches JS. We
+   * invoke the handler directly with an explicit empty args array to sidestep the null. The legacy
+   * (bridge) handler tolerates the empty array too, so this is safe on both architectures.
+   */
+  private fun ReactContext.callHMRClientMethod(methodName: String) {
+    val hmrClient = getJSModule(HMRClient::class.java) ?: return
+    val method = HMRClient::class.java.getMethod(methodName)
+    if (Proxy.isProxyClass(hmrClient.javaClass)) {
+      Proxy
+        .getInvocationHandler(hmrClient)
+        .invoke(
+          hmrClient,
+          method,
+          emptyArray<Any?>()
+        )
+    } else {
+      method.invoke(hmrClient)
+    }
+  }
+
   @OptIn(DelicateCoroutinesApi::class)
   fun openJSInspector() {
     val devSettings = devSettings ?: return

package/ios/DevMenuManager.swift

@@ -110,6 +110,9 @@ open class DevMenuManager: NSObject {
 
   private var isNavigatingHome = false
 
+  private var isReloading = false
+  private var lastReloadEventAt: Date?
+
   weak var hostDelegate: DevMenuHostDelegate?
 
   @objc
@@ -214,6 +217,8 @@ open class DevMenuManager: NSObject {
   public func setAppContext(_ appContext: AppContext?) {
     currentAppContext = appContext
     if appContext != nil {
+      isReloading = false
+      lastReloadEventAt = Date()
       isNavigatingHome = false
       isReactAppRunning = true
       // Re-run packager connection setup now that the app context (and devSettings) is available.
@@ -225,6 +230,20 @@ open class DevMenuManager: NSObject {
     updateAutoLaunchObserver()
   }
 
+  /**
+   Clears the app context, but only if `context` is still the active one.
+   On reload the incoming context's `OnCreate` can run before the outgoing context's
+   `OnDestroy`, so an unconditional reset would wipe the new context and leave the dev
+   menu unable to open.
+   */
+  @objc
+  public func clearAppContext(current context: AppContext?) {
+    if currentAppContext != nil && currentAppContext !== context {
+      return
+    }
+    setAppContext(nil)
+  }
+
   @objc
   public func updateCurrentManifest(_ manifest: Manifest?, manifestURL: URL?) {
     currentManifest = manifest
@@ -524,8 +543,21 @@ open class DevMenuManager: NSObject {
   }
 
   func reload() {
-    let devToolsDelegate = getDevToolsDelegate()
-    devToolsDelegate?.reload()
+    let now = Date()
+    if isReloading || (lastReloadEventAt.map { now.timeIntervalSince($0) < 0.5 } ?? false) {
+      lastReloadEventAt = now
+      return
+    }
+    guard let devToolsDelegate = getDevToolsDelegate() else {
+      return
+    }
+    isReloading = true
+    lastReloadEventAt = now
+    // Clear the guard even if a new app context never registers, for example a failed reload.
+    DispatchQueue.main.asyncAfter(deadline: .now() + 5) { [weak self] in
+      self?.isReloading = false
+    }
+    devToolsDelegate.reload()
   }
 
   func togglePerformanceMonitor() {

package/ios/DevMenuPackagerConnectionHandler.swift

@@ -92,7 +92,7 @@ class DevMenuPackagerConnectionHandler {
 
     switch command {
     case "reload":
-      devDelegate.reload()
+      manager.reload()
     case "toggleDevMenu":
       self.manager?.toggleMenu()
     case "toggleElementInspector":

package/ios/Modules/DevMenuModule.swift

@@ -10,7 +10,7 @@ open class DevMenuModule: Module {
     }
 
     OnDestroy {
-      DevMenuManager.shared.setAppContext(nil)
+      DevMenuManager.shared.clearAppContext(current: self.appContext)
       // Cleanup registered callbacks when the module is destroyed to prevent leaking into other bridges.
       if DevMenuManager.wasInitilized {
         DevMenuManager.shared.registeredCallbacks = []

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-dev-menu",
-  "version": "56.0.16",
+  "version": "56.0.18",
   "description": "Expo/React Native module with the developer menu.",
   "main": "build/DevMenu.js",
   "types": "build/DevMenu.d.ts",
@@ -32,15 +32,15 @@
     "@types/node": "^22.14.0",
     "react": "19.2.3",
     "react-native": "0.85.3",
-    "expo-module-scripts": "56.0.2",
-    "expo": "56.0.7",
-    "babel-preset-expo": "56.0.13"
+    "babel-preset-expo": "56.0.16",
+    "expo-module-scripts": "56.0.3",
+    "expo": "56.0.13"
   },
   "peerDependencies": {
     "expo": "*",
     "react-native": "*"
   },
-  "gitHead": "97faadd78ca3d73250127fedf09dd6a27b21db5b",
+  "gitHead": "b293744c7b199c6cbe910188863e93a174c21250",
   "scripts": {
     "build": "expo-module build",
     "clean": "expo-module clean",

package/plugin/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["./src/withdevmenu.ts"],"version":"5.9.2"}
+{"root":["./src/index.ts","./src/withdevmenu.ts"],"version":"6.0.3"}