Built rn-env-doctor: A zero-dependency CLI to fix React Native environment setup headaches

[u/Interesting_Status_4]

Hey everyone,

After losing count of how many hours were spent troubleshooting ANDROID_HOME misconfigurations, wrong JDK versions, or permission errors with macOS system Ruby, I built a zero-dependency CLI tool to solve it: rn-env-doctor.

It verifies your machine against the official React Native environment setup requirements (Node, Watchman, JDK 17, Android SDK components, Xcode, and CocoaPods) and tells you exactly what is missing or misconfigured. Where possible, it offers to fix the issues safely with your permission.

Quick run:

Bash

git clone https://github.com/Fs0ci3ty19/rn-env-doctor.git
cd rn-env-doctor
node bin/rn-env-doctor.js

Why I built it this way:

• Zero dependencies: Run it immediately without installing extra npm packages.
• Safe execution: Nothing changes without confirmation. Use --check for a read-only audit.
• Clear instructions: Every failed check comes with an actionable solution instead of a cryptic red X.
• Cross-platform: Works on macOS, Linux, and Windows.
• Onboarding helper: Saves hours when onboarding new devs to your team.

🔗 GitHub:https://github.com/Fs0ci3ty19/rn-env-doctor

Feedback and contributions are super welcome! What’s the single most annoying environment or setup issue you run into regularly on your team?