# Sherlo
**Sherlo is a visual regression testing tool for React Native.** Capture screenshots on iOS and Android simulators in the cloud, detect visual changes, and review them as a team before release. Integrates with Storybook. Used in production by React Native teams, from fintech to social apps. Free plan, no credit card.
βΆοΈ [Sherlo in 2 minutes](https://sherlo.io/#video)
### How It Works
1. **πΈ Capture** - Sherlo takes screenshots of your UI on iOS and Android simulators in the cloud
2. **π Detect** - All visual changes are automatically detected by comparison with previous versions
3. **π Review** - Your team reviews detected changes before they go live
### Key Benefits
- **πΌοΈ Pixel Perfection** - Your designs, implemented exactly as intended
- **β Ship with Confidence** - See exactly what changed before release - no surprises in production
- **β±οΈ Minutes Not Hours** - Forget device-by-device checks - every UI update caught automatically
- **π€ Review Together** - One place where devs, designers, PMs, and QA collaborate
- **π± Real Mobile Testing** - Native iOS & Android testing - not web approximations like React Native Web
- **βοΈ Visual Testing Cloud** - You build, we test - on infrastructure built specifically for mobile UI testing
## Quick Start
#### 1) Install Sherlo
```bash
npx sherlo init
```
#### 2) Run visual tests
```bash
npx sherlo test
```
π **That's it!** Your visual testing is ready.
[Full documentation β](https://sherlo.io/docs)
## Examples
Try Sherlo with ready-to-run example projects.
### What's Inside
- **π± Minimal Apps** - React Native + Storybook integrated with Sherlo
- **π€ GitHub Actions** - CI/CD workflows for automated testing
- **π Different Workflows** - Standard builds, OTA updates, and Expo cloud builds
[Browse examples β](./examples)
## Review App
Review visual changes across devices in one web app as a team - from developers to designers.
### Features
- **πΈ Visual Comparison** - Compare before/after screenshots with highlighted changes
- **π¬ Team Feedback** - Approve or report changes and leave comments
- **π Code Inspector** - Inspect React Native styles directly in the browser
- **π¨ Figma Preview** - Compare UI with Figma designs side-by-side
- β¦and more
## New to Storybook?
Sherlo integrates with Storybook - a tool that helps you develop and document UI components.
**π§ Build in Isolation** - No need to run the full app or navigate through screens
**π Auto Docs** - Write once, get both components and documentation
**π Perfect with Sherlo** - Plug in and get iOS & Android visual tests automatically - zero extra effort
[Storybook for React Native β](https://github.com/storybookjs/react-native)
## Join the Community
π¬ [Join our Discord](https://discord.gg/G7eqTBkWZt) - Get help and chat with the community
π’ [Follow us on X](https://x.com/sherlo_io) - Latest updates and React Native tips
π§ Questions? contact@sherlo.io
---
