# Add an AR face mask in React Native

> Download a face-tracked AR mask through Cloud Filters, apply it through the React Native SDK, and keep the UI synchronized.

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

Product: Nosmai Effects
Platform: React Native
Group: guide
Source: https://nosmai.com/docs/effects/guides/effects/add-an-ar-mask/react-native/

Available platform versions:
- iOS: https://nosmai.com/docs/effects/guides/effects/add-an-ar-mask/ios.md
- Android: https://nosmai.com/docs/effects/guides/effects/add-an-ar-mask/android.md
- Web: https://nosmai.com/docs/effects/guides/effects/add-an-ar-mask/web.md
- React Native: https://nosmai.com/docs/effects/guides/effects/add-an-ar-mask/react-native.md
- Flutter: https://nosmai.com/docs/effects/guides/effects/add-an-ar-mask/flutter.md



## Prerequisites

- A working [React Native quickstart](/docs/effects/quickstart/react-native/)
- A compatible AR mask available through Cloud Filters

## Obtain and apply the mask

```tsx
const page = await NosmaiCameraSdk.getCloudFilters({
  packageType: 'effect',
  page: 1,
  limit: 20,
});
const mask = page.filters[0];

if (mask) {
  const download = await NosmaiCameraSdk.downloadCloudFilter(mask);
  await NosmaiCameraSdk.applyEffect(download.path);
}
```

## Remove it

```tsx
await NosmaiCameraSdk.removeEffect(download.path);
```

## Verify it worked

Test face loss, reacquisition, rotation, navigation, and Fast Refresh cleanup
on both native platforms.

## Common errors

| Error or symptom | Fix |
| --- | --- |
| `E_INVALID_PACKAGE_PATH` | Use the successful Cloud Filter download result |
| Mask appears after screen closes | Ignore stale Promises and call cleanup during unmount |
| Selection becomes stale | Observe active effects instead of trusting the last button tap |

## Next steps

- [Learn about face triggers](/docs/effects/concepts/triggers/)
- [Download a Cloud Filter in React Native](/docs/effects/guides/filters/download-a-cloud-filter/react-native/)

## References

- [React Native installation guide](/docs/effects/installation/react-native/)