r/reactnative • u/raju_gupta • 12h ago
Tutorial Debugging native iOS crashes in React Native 0.87.1 with Xcode 27.1 and LLDB
**Setup**
- React Native 0.87.1
- Xcode 27.1
- iOS Simulator (iPhone 18 Pro, iOS 27.0)
I've hit this a lot: the app dies on iOS, the JS console is quiet, and it's not obvious where to start. Most of the time the answer is on the native side, so here's the process I use. I call it RIFT.
**R – Reproduce**
Run the app from Xcode (not just from the terminal) and trigger the crash. Add a breakpoint near where you think it happens so you can pause instead of watching the app die.
**I – Investigate**
When it stops or crashes, look at the exception message and the backtrace in the left panel. In my example, a native module method called from JS threw an uncaught NSException, and the console printed the reason. Then in LLDB:
- `bt` – print the backtrace
- `frame select <n>` – jump to a specific frame
- `po` / `p` / `expression` – inspect values at that point
**F – Fix**
Change the actual cause in the native code (in my case, the method wasn't validating its input), not just the symptom.
**T – Test**
Re-run the exact same steps and confirm the crash is gone. Skipping this step is how "fixed" bugs come back.
I recorded a ~22 min live walkthrough of this on a real crash if it's useful to anyone:
Happy to answer questions. What's your usual first step when a crash shows no JS error?
