# React Native

> Integrate the stable Nosmai Effects SDK for React Native with Fabric camera preview, TurboModule controls, beauty, Cloud Filters, games, capture, and recording.

> For AI agents: the complete documentation index is at https://nosmai.com/llms/effects.txt

Product: Nosmai Effects
Group: platform-guides
Source: https://nosmai.com/docs/effects/platforms/react-native/

## Start here

- [Install for React Native](/docs/effects/installation/react-native/)
- [Build the React Native quickstart](/docs/effects/quickstart/react-native/)
- [Install the stable package from npm](https://www.npmjs.com/package/@nosmai/react-native-effects-sdk)

## Requirements

| Item | Requirement |
| --- | --- |
| React Native | 0.81.5 with React 19.1 |
| Architecture | New Architecture with Fabric and TurboModules |
| iOS host | iOS 15, physical arm64 device |
| Android host | API 24 baseline, physical `arm64-v8a` device |

## Available features

- Fabric-native camera preview and lifecycle methods
- beauty, makeup, reshape, color, and eye controls
- local and cloud `.nosmai` packages, including games
- manual backgrounds using local file URIs
- processed photo capture and video recording
- bounded 1 through 5 FPS processed-frame sampling for analysis

The package is publicly distributed on npm under the `latest` tag. Processed
frame sampling uses CPU and base64 copies and is not a zero-copy streaming
bridge.

## Important ownership rules

Initialize once, mount one `NosmaiCameraView`, start processing after the view
is ready, and call cleanup when the camera experience ends. Stop and finalize
recording before camera switch, pause, navigation, or teardown.

## Next steps

- [Apply beauty in React Native](/docs/effects/guides/effects/apply-a-beauty-filter/react-native/)
- [Control a camera game in React Native](/docs/effects/guides/effects/control-a-camera-game/react-native/)
- [Replace the background in React Native](/docs/effects/guides/background/replace-the-background/react-native/)
- [Record video in React Native](/docs/effects/guides/output/record-video/react-native/)

## References

- [Platform support](/docs/effects/platform-support/)
- [React Native package on npm](https://www.npmjs.com/package/@nosmai/react-native-effects-sdk)
- [React Native repository](https://github.com/nosmai/nosmai_effects_sdk_react_native)
- [Troubleshooting](/docs/effects/troubleshooting/)
