# Samples

> Start from an official sample, add your own app-bound license key, and test the matching native artifacts on a physical device.

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

Product: Nosmai Effects
Group: reference
Source: https://nosmai.com/docs/effects/samples/

## Official samples

| Platform | Sample | What it demonstrates |
| --- | --- | --- |
| Flutter | [Package example](https://github.com/nosmai/nosmai_effects_sdk_flutter/tree/main/example) | Preview lifecycle, beauty, local and cloud packages, games, capture, and recording |
| Android | [Android SDK repository](https://github.com/nosmai/nosmai_effects_sdk_android) | AAR integration and native camera/effects usage |
| iOS | [iOS SDK repository](https://github.com/nosmai/nosmai_effects_sdk_ios) | CocoaPods and framework integration |
| React Native | [Package example](https://github.com/nosmai/nosmai_effects_sdk_react_native/tree/main/example) | Fabric preview, TurboModule methods, beauty, cloud, media, and lifecycle |
| Web preview | Preview bundle sample supplied with the release archive | Browser initialization and authored package application |

The React Native repository and npm package provide the stable `1.0.0` release.
The Web package remains an authorized developer preview and is supplied through
the preview onboarding flow.

## Live-streaming samples

| Provider | Platform | Official sample |
| --- | --- | --- |
| Agora | Flutter | [Nosmai Agora bridge](https://github.com/nosmai/nosmai_agora_bridge) |
| LiveKit | Flutter | [Nosmai LiveKit bridge](https://github.com/nosmai/nosmai_livekit_bridge) |
| LiveKit | Android | [Native Android example](https://github.com/nosmai/nosmai-livekit-android-example) |
| LiveKit | iOS | [Native iOS example](https://github.com/nosmai/nosmai-livekit-ios-example) |
| Raw WebRTC | Android | [Native Android example](https://github.com/nosmai/nosmai-webrtc-android-example) |
| Raw WebRTC | iOS | [Native iOS example](https://github.com/nosmai/nosmai-webrtc-ios-example) |

## Before running a sample

1. Register the sample's exact application ID, bundle identifier, or Web origin
   in Nosmai Console.
2. Use a platform-specific license key.
3. Add the verified native AAR or framework version expected by the sample.
4. Test on a supported physical device.
5. Replace sample credentials before committing or publishing your fork.

## Use samples safely

Sample applications demonstrate SDK behaviour, not your final architecture.
Move license keys into private build configuration, keep one camera owner, and
implement your own permission explanation, analytics, UI state, and media
storage policy.

## Next steps

- [Choose a quickstart](/docs/effects/introduction/#start-building)
- [Install on Flutter](/docs/effects/installation/flutter/)
- [Create a license key](/docs/effects/license-key/)
- [Choose a live-streaming integration](/docs/effects/integrations/live-streaming/)
- [Troubleshoot a sample](/docs/effects/troubleshooting/)

## References

- [Nosmai Console](https://console.nosmai.com/)
- [Platform support](/docs/effects/platform-support/)
- [React Native package](https://www.npmjs.com/package/@nosmai/react-native-effects-sdk)