🤖 React Native AI Tester

An AI-powered testing library that automatically analyzes your React Native app — just like a real human QA tester.

react-native-ai-tester runs automated flows, captures UI screens, checks design quality, detects functional issues, and generates a detailed AI QA report using GPT-based analysis.

🧠 Features

✅ Automatically runs through your app (Appium or Maestro compatible)
✅ AI-driven UI/UX analysis using OpenAI Vision
✅ Detects design inconsistencies, alignment issues, and crashes
✅ Generates visual QA reports (HTML/JSON)
✅ Easy CLI + JavaScript API
✅ Works with Android & iOS builds

⚙️ Installation

npm install react-native-ai-tester
# or
yarn add react-native-ai-tester

💡 You’ll also need Node.js ≥ 18, Appium, and an OpenAI API key.

🧩 First-Time Setup (Wizard)

The library includes an interactive setup wizard to automatically configure your environment.

Just run:

npx react-native-ai-tester setup

The wizard will:

1. Check your Node.js version
2. Verify or install Appium
3. Ask for your OpenAI API key
4. Detect your Android/iOS environment
5. Save everything in .ai-tester-config.json

Example:

🧠 React Native AI Tester — Setup Wizard

✅ Node.js version: 20.11.1
✅ Appium installed (v2.2.0)
🔑 Enter your OpenAI API key (starts with sk-): sk-xxxxxxxxxxxxxxxxx
✅ Configuration saved to .ai-tester-config.json

🚀 Quick Start (CLI)

After setup, run your first AI test:

npx react-native-ai-tester   --app ./android/app/build/outputs/apk/release/app-release.apk   --output ./ai-qa-report.html

This will:

1. Launch your app on an emulator or simulator
2. Capture screens and flows
3. Analyze them using GPT Vision
4. Generate a full AI QA report

💻 Programmatic Usage

import { runAITest } from "react-native-ai-tester";

(async () => {
  const report = await runAITest({
    appPath: "./android/app/build/outputs/apk/release/app-release.apk",
    includeVisualCheck: true,
    output: "./ai-qa-report.html",
  });

  console.log("✅ AI QA Report generated at:", report);
})();

🧪 Development Setup

git clone https://github.com/yourorg/react-native-ai-tester.git
cd react-native-ai-tester
npm install
npm run build
npm link

Then test locally:

react-native-ai-tester setup
react-native-ai-tester --app ./path/to/app.apk

⚡️ CI/CD Integration Example

You can integrate this library into GitHub Actions, Bitrise, or any CI tool.

Example: GitHub Actions

name: AI QA Test

on:
  push:
    branches: [ main ]

jobs:
  ai-test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: 18

      - name: Install dependencies
        run: npm install

      - name: Run AI QA Test
        run: |
          npx react-native-ai-tester setup
          npx react-native-ai-tester --app ./android/app/build/outputs/apk/release/app-release.apk --output ./ai-qa-report.html

      - name: Upload Report
        uses: actions/upload-artifact@v4
        with:
          name: ai-qa-report
          path: ai-qa-report.html

🧰 Roadmap

• [ ] Full Appium/Detox test flow automation
• [ ] Visual diff between builds
• [ ] Accessibility & performance audits
• [ ] PDF dashboard export
• [ ] CI/CD plugin support

⚖️ License

MIT License © 2025
Developed with ❤️ for smarter mobile testing.