argent-react-native-app-workflow

Run React Native apps on simulators or emulators with Metro and debug failures.

34|2|Updated Aug 16, 2025
One-click install
npx skills add https://github.com/FilenCloudDienste/filen-ts --skill argent-react-native-app-workflow-filenclouddienste
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: argent-react-native-app-workflow
Source: https://github.com/FilenCloudDienste/filen-ts/tree/main/.claude/skills/argent-react-native-app-workflow
Command: npx skills add https://github.com/FilenCloudDienste/filen-ts --skill argent-react-native-app-workflow-filenclouddienste

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you get a React Native app running and keeps it running by providing a reliable workflow for starting Metro, building/installing on simulators/emulators, and diagnosing common build and runtime failures.

Core Features & Use Cases

  • Metro-first workflow: Prevents port conflicts and ensures the app connects to the correct running Metro instance before launching the app.
  • Build and runtime troubleshooting: Guides cleanup steps for common failures (e.g., xcodebuild exit code 65, CocoaPods issues, cache resets) and tells you when to stop guessing and ask for clarification.
  • Runtime debugging and testing: Directs you to the right tools to inspect logs, component trees, screenshots, evaluate JS, and run unit/E2E tests (when configured).

Use Case: You changed native iOS dependencies and the app fails to build; follow the workflow to reset caches, reinstall pods correctly, rebuild using the right iOS workspace, and then use the provided runtime debugging tools if the build succeeds but the app crashes.

Quick Start

Follow the workflow to start Metro safely, then run the iOS simulator or Android emulator from the project root using the repo’s custom npm/yarn scripts and tool-assisted checks.

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 debug a React Native app that fails to launch on iOS and Android?

To debug a React Native app that fails to launch, start the Metro bundler first to prevent port conflicts, then use custom npm or yarn scripts to build and install the app on iOS simulators or Android emulators while checking project configurations.

Why does my React Native iOS build fail with CocoaPods errors after changing dependencies?

React Native iOS builds fail with CocoaPods errors when native dependencies change. Reset caches, reinstall pods correctly using the appropriate iOS workspace, and rebuild to resolve the installation failures and clear the build state.

What is the best way to prevent Metro bundler port conflicts in React Native?

The best way to prevent Metro bundler port conflicts is using a Metro-first workflow. Start Metro safely to ensure it reaches the expected port, validate its reachability, and confirm the app connects to the correct running instance before launching.

How do I inspect runtime logs and component trees in a React Native simulator?

To inspect runtime logs and component trees in a React Native simulator, use purpose-built agent tools after a successful build. These tools evaluate JavaScript, capture screenshots, inspect logs, and control devices while reloading the app.

Can I run unit and E2E tests using this React Native debugging workflow?

Yes, you can run unit and E2E tests using this React Native debugging workflow. The workflow directs you to the right tools to execute tests using the project's existing configurations when they are properly set up.

What should I do when React Native build errors persist after clearing the cache?

When React Native build errors persist after clearing the cache and reinstalling pods, stop guessing and ask for clarification. The workflow advises checking custom package scripts and validating Metro reachability before proceeding.