React Native Test App (RNTA) provides test apps for all platforms as a package. It handles the native bits for you so you can focus on what's important: your product.

• Quick Start ⚡
• Migrate an Existing Test App 📖
• Configuring the Test App 📖
• Upgrading the Test App 📖
• Learn More 🔍
• Libraries Using RNTA 📚
• Known Issues ⚠️
• Contributing 🤝
• License 📝

If you want to migrate an existing test app for a library, follow the dedicated guide in the wiki.

You can generate a new project using npx:

npx --package react-native-test-app@latest init

In this example, we will create a project named "sample" in sample with apps for all platforms:

✔ What is the name of your test app? … sample
? Which platforms do you need test apps for? ›
Instructions:
    ↑/↓: Highlight option
    ←/→/[space]: Toggle selection
    a: Toggle all
    enter/return: Complete answer
◉   Android
◉   iOS
◉   macOS
◉   Windows
✔ Where should we create the new project?? … sample

Install npm dependencies inside the new project folder:

Yarn:

cd sample
yarn

npm:

cd sample
npm install

Once the dependencies are installed, follow the platform specific instructions in the wiki.

• 🗣️ If you want to learn how RNTA is used at Microsoft, check out the following talks:
  • "Improve all the repos – exploring Microsoft’s DevExp" by @kelset and @tido64 from React Native Europe 2021.
  • "Our Journey of Making React Native a Preferred Choice" by @kelset and @tido64 from React Native Europe 2023.
• 📖 In the wiki, you can read more about the motivation and the design of this tool.

Are you using RNTA? Submit a PR to add it to the list!

For a list of known issues and workarounds, please refer to the Troubleshooting wiki.

Thank you for your interest in this project! We welcome all contributions and suggestions!

Take a look at CONTRIBUTING.md for details.

react-native-test-app is MIT licensed.