Expo

Expo Go is not supported

Hakka includes native code. Expo Go cannot load it — use a development build (npx expo run:ios / npx expo run:android).

What you'll have

By the end of this page, your Expo app captures network requests and shows them in the Hakka inspector. No proxy, no certificate, no cloud account.

Install

npm

bash npm install hakka-react-native

pnpm

bash pnpm add hakka-react-native

yarn

bash yarn add hakka-react-native

bun

bash bun add hakka-react-native

Then install the recommended Expo peers:

Terminal

npx expo install @react-native-clipboard/clipboard expo-dev-client

Clipboard is optional — if your app already uses expo-clipboard, Hakka’s copy actions use it automatically and you can skip the community package.

Setup

1. Add the plugin to app.json

   app.json

   {
     "expo": {
       "plugins": [["hakka-react-native", {}]]
     }
   }

   The plugin adds Android debug/release Hakka network artifacts during prebuild. iOS dependencies are handled by React Native autolinking and CocoaPods.

2. Opt in to Android performance collectors (optional)

   app.json

   {
     "expo": {
       "plugins": [["hakka-react-native", { "androidPerformance": true }]]
     }
   }

   Performance collectors stay opt-in so the base native capture setup stays small.

3. Rebuild native projects

   Terminal

   npx expo prebuild --clean
   npx expo run:ios
   npx expo run:android

4. Verify it works

   Shake the device or press m in the Expo CLI to open the dev menu, then open the Hakka overlay. Make any network request in your app — you should see it appear in the inspector with method, status, and timing.

   

Day-to-Day Development

After your development build is installed, JS-only changes do not require a rebuild:

Terminal

npx expo start

You only need to rebuild (npx expo run:ios / npx expo run:android) when you change native dependencies or plugin configuration.

Optional UI Peers

If you import hakka-react-native/ui, install the UI peers:

Terminal

npx expo install react-native-gesture-handler react-native-reanimated react-native-safe-area-context react-native-svg react-native-worklets

Then add the Worklets Babel plugin last in babel.config.js:

babel.config.js

module.exports = function (api) {
  api.cache(true)

  return {
    presets: ['babel-preset-expo'],
    plugins: ['react-native-worklets/plugin'],
  }
}

SDK 56 Note

Expo SDK 56’s Apple native-module improvements do not change Hakka’s current integration path. Hakka remains a standalone React Native package with a TurboModule/codegen bridge over native Android and Swift SDKs.

Next steps

Capture modesChoose between auto, native, and JS capture for your setup.

Production safetyStrip Hakka from release builds without changing call sites.

BreakpointsPause and edit requests or responses at runtime.