react-native-testsmith

Production-ready CLI for React Native unit testing with Jest and React Native Testing Library.

1.0.1 Update

• Switched to API-first AI generation (Ollama removed on this branch)
• init now runs Jest setup automatically
• generate now runs full pipeline: scan + API check + per-file AI generation
• Long files are chunked automatically for free-tier model limits
• Added per-file progress logs and final generation summary counts

Why this exists

• Automates painful Jest + RN config
• Scans your components/screens and builds metadata
• Generates stable test templates quickly
• Supports API-driven AI test generation with chunking for large files

Install

npm i -g react-native-testsmith

Or inside a project:

npm i -D react-native-testsmith

For local development from this repo:

npm i
npm run build
npm i -g .
react-native-testsmith --help

If you see command not found, install globally (npm i -g .) or run with npx.

Commands

react-native-testsmith init
react-native-testsmith generate
react-native-testsmith generate --failed-only
react-native-testsmith doctor
react-native-testsmith doctor --json

Typical workflow

react-native-testsmith init
react-native-testsmith generate

Full setup steps (end-to-end)

1. Install CLI

npm i -g react-native-testsmith

2. Move to your React Native app

cd mobileApp

3. Create config

react-native-testsmith init

4. Configure Jest and required mocks

# already done by init
# optional manual run:
react-native-testsmith setup

5. Run complete generation pipeline (scan + API check + per-file AI generation)

react-native-testsmith generate

6. Verify setup health

react-native-testsmith doctor
react-native-testsmith doctor --json

Setup output

setup creates:

• jest.config.js
• jest.setup.ts
• __mocks__/fileMock.tsx
• __mocks__/styleMock.ts
• RN mock shims for common libraries
• installs @testing-library/react-native if missing

When you pass --with-native-mocks, setup also creates:

• __mocks__/react-native-config.ts
• __mocks__/react-native-device-info.ts
• __mocks__/react-native-vector-icons-MaterialIcons.ts

Use --dry-run to preview all setup changes safely before writing files.

init runs setup automatically. You can still run setup directly when needed.

Test output structure

generate mirrors your source structure in __tests__ when testFileStyle is tests-dir.

Example:

• src/components/Button.tsx -> __tests__/components/Button.test.tsx
• src/screens/auth/Login.js -> __tests__/screens/auth/Login.test.js

API notes

• generate is the primary AI command now (project-wide).
• RN_TESTSMITH_API_URL overrides endpoint and RN_TESTSMITH_API_KEY is optional.
• Long files are chunked automatically and then synthesized.
• scan includes App.ts, App.js, App.tsx, and App.jsx at project root.
• Terminal output includes per-file progress and final AI response/generated counts.
• 5xx API errors/timeouts are retried automatically (configurable via env vars).
• Failed files are stored in .react-native-testsmith/failed-files.json and can be retried with generate --failed-only.

CI

GitHub Actions CI is included at .github/workflows/ci.yml:

• typecheck
• build
• test

Notes

• Generated tests are templates and should be refined by developers.
• Use --force if you want to overwrite existing generated files.

Sponsor request

react-native-testsmith is currently free to use.

If this project saves your team time, please sponsor development so we can:

• maintain and improve templates faster
• add broader framework support
• provide optional hosted model inference in the future
• keep docs, CI, and releases production-grade

Interested in sponsoring? Open an issue with title Sponsorship and we will coordinate.