rn-run-0.1.12 is not a library.

rn-run

React Native Development Automation Tool for MacOS

rn-run is a command-line utility written in Rust that streamlines React Native development by automating the entire app launch process for both iOS and Android platforms.

What It Does

rn-run is a "one-command solution" for React Native developers that eliminates the tedious manual steps typically required to run React Native apps. Instead of manually:

Stopping existing Metro bundler processes
Closing simulators
Managing terminal windows
Installing dependencies
Starting the packager
Launching the simulator/emulator

You simply run rn-run --ios or rn-run --android and the tool handles everything automatically.

Usage:

rn-run [OPTIONS]

Options:

PLATFORM:
  -i, --ios                    Run iOS
  -a, --android                Run Android
  -s, --simulator <SIMULATOR>  Specify iOS simulator (default: iPhone 15)
  -c, --clean-install          Clean install before running
  -u, --upgrade                Aggressive cleanup for RN upgrades

DIAGNOSTICS:
  --check-env                  Check development environment setup
  --rn-version                 Show detected React Native version
  --list-simulators            List available iOS simulators
  --list-emulators             List available Android emulators

PROCESS MANAGEMENT:
  --kill-metro                 Kill Metro bundler on port 8081
  --quit-simulator             Quit iOS Simulator
  --screenshot                 Take screenshot of running simulator/emulator
  --output <PATH>              Output path for screenshot (optional)
  --update                     Update rn-run to latest version
  --logs                       List recent build logs
  --show-log                   Show the most recent build log

CLEANUP:
  --clean-modules              Delete node_modules only
  --clean-pods                 Clean iOS Pods, Podfile.lock, build
  --clean-gradle               Clean Android build caches
  --delete-simulators          Delete all iOS simulators

BUILD:
  --pod-install                Run pod install

OUTPUT:
  --json                       Output in JSON format (for AI/automation)
  -h, --help                   Print help
  -V, --version                Print version

Clean Install (`-c`)

Performs a standard clean install:

Deletes node_modules
Runs npm install or yarn install
Runs pod install (iOS only)

Upgrade Clean (`-u`)

Performs an aggressive cleanup for React Native upgrades:

Everything in clean install, plus:
iOS: Deletes ios/Pods, ios/build, ios/Podfile.lock, package-lock.json
Android: Deletes android/build, android/app/build, android/.gradle, package-lock.json

Prebuild Script (Automatic)

If your package.json contains a "prebuild" script, rn-run will automatically run it before building:

{
  "scripts": {
    "prebuild": "your-prebuild-commands-here"
  }
}

When detected, rn-run runs npm run prebuild before the build command. No configuration needed.

Screenshot

Capture screenshots of running simulators/emulators:

# iOS simulator (default)
rn-run --screenshot
rn-run --screenshot --output myapp.png

# Android emulator
rn-run --screenshot -a
rn-run --screenshot -a --output myapp.png

# JSON output for automation
rn-run --screenshot --json

Screenshots are saved to the current directory with a timestamp by default, or specify a custom path with --output.

Self-Update

Update rn-run to the latest version from crates.io:

rn-run --update

This checks crates.io for the latest version and runs cargo install rn-run --force if a newer version is available.

Build Logs

Build output is automatically saved to ~/.rn-run/logs/ for debugging:

# List recent logs
rn-run --logs

# View the most recent log
rn-run --show-log

# JSON output for automation
rn-run --logs --json

Logs are created automatically when running rn-run -i or rn-run -a
Last 10 logs are retained (older logs are automatically deleted)
Log files include timestamps: rn-run-ios-2024-01-30_14-30-00.log

AI/Automation Usage

rn-run is designed to work with AI assistants like Claude. Use --json for structured output:

# Check environment (AI can parse and diagnose issues)
rn-run --check-env --json

# Get RN version (determines npm vs yarn)
rn-run --rn-version --json

# List available simulators
rn-run --list-simulators --json

# Take screenshot
rn-run --screenshot --json

See CLAUDE.md for comprehensive AI usage documentation, including:

Decision trees for debugging build errors
JSON response formats
Common error patterns and fixes

Setup

On MacOS you will need to set Ask before closing to Never in Terminal settings

Installation

Install Rust, more info: https://www.rust-lang.org/learn/get-started

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Build & Install

cargo install rn-run

This will build and install the binary to ~/.cargo/bin/ on MacOS and add it to your PATH.

Releasing (Maintainers)

To publish a new release:

Update version in Cargo.toml
Commit the version bump
Run the release script:

./scripts/release.sh

This will:

Publish to crates.io
Create and push a git tag (vX.X.X)
Create a GitHub release with auto-generated notes

Requires: GitHub CLI (gh) authenticated.

Support the Project

You can donate using Monero (XMR)

Monero Address:

8AGHjrStt9EWEzKao7nvZNEGUHMHjWcJeWXts4wJsaog4eiE5Az4g2UjddiMLHLF6WPrKG2XT5rhcHrqqjTeedSo1RJZhNj

rn-run 0.1.12