argent-react-native-app-workflow

Start and debug React Native apps on iOS simulators or Android emulators.

Updated May 7, 2026

Search Tags:#react native #build troubleshooting #ios simulator #android emulator #deterministic workflows #metro debugging #xcodebuild exit code 65

Ready to run

npx skills add https://github.com/softwarebyze/Backgammon-Mastermind --skill argent-react-native-app-workflow

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: argent-react-native-app-workflow
Source: https://github.com/softwarebyze/Backgammon-Mastermind/tree/main/.agents/skills/argent-react-native-app-workflow
Command: npx skills add https://github.com/softwarebyze/Backgammon-Mastermind --skill argent-react-native-app-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you reliably start, debug, and recover React Native apps running on iOS simulators or Android emulators when Metro, builds, or runtime behavior go wrong.

Core Features & Use Cases

Discover the correct run workflow by checking project-specific configuration and scripts before issuing default React Native commands.
Start and validate Metro by preventing duplicate servers on the correct port and confirming the app points to the reachable Metro instance.
Troubleshoot build and runtime issues with ordered clean/reinstall steps (Pods, caches, node_modules) and focused tools for logs, component inspection, JS evaluation, and app reload/restart.
Use-case examples: fixing xcodebuild failures by clearing Pods and caches, resolving “port already in use” Metro issues, and reloading bundles after JS/config changes without unnecessary reinstalls.

Quick Start

Tell the AI: "I’m trying to run my React Native app on the iOS simulator and Metro errors are happening—give me the exact workflow to start Metro, run the app, and debug the failure."

Frequently Asked Questions about argent-react-native-app-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I fix xcodebuild exit code 65 when building my React Native iOS app?▼

Fixing xcodebuild exit code 65 in React Native involves applying ordered clean and reinstall steps, specifically clearing Pods and build caches. This workflow resolves the underlying dependency or caching issues causing the build failure.

Why does my React Native Metro server say the port is already in use?▼

A React Native Metro server reports a port conflict when a duplicate instance is running. You resolve it by ensuring a single reachable Metro instance on the correct port and confirming the app points to that specific server.

What is the best way to debug a React Native app on an iOS simulator?▼

The best way to debug a React Native app on an iOS simulator is using a deterministic workflow that validates Metro, checks project scripts, and uses logs, component inspection, and JS evaluation to diagnose runtime issues.

How do I reload a React Native bundle after making JS changes without reinstalling?▼

To reload a React Native bundle after JS changes without reinstalling, use the app reload or restart tools provided by the workflow. This refreshes the bundle directly from the active Metro instance.

Can I use the same React Native workflow for Android emulators?▼

Yes, the workflow supports starting and debugging React Native apps on Android emulators. It discovers project-specific scripts and applies safe clean or reinstall steps tailored to the Android environment.

What should I do if my React Native build keeps failing after cleaning caches?▼

If your React Native build keeps failing after clean and reinstall steps, the workflow enforces guidance to stop after repeated failures. Continuing to apply clean steps blindly is discouraged to prevent further environment corruption.