react-native-vision-camera-spoof-detector 1.0.27 → 1.1.0

package/README.md

@@ -20,9 +20,11 @@ High-performance face anti-spoofing and liveness detection module for React Nati
 ## 📋 Requirements
 
 - React Native >= 0.60.0
-- react-native-vision-camera >= 4.6.4
-- react-native-reanimated >= 3.0.0
-- react-native-worklets-core >= 1.0.0
+- React Native Vision Camera `^4.6.4` or `^5.0.0`
+- `react-native-reanimated` `^3.0.0`
+- `react-native-worklets` `^0.12.0`
+- `react-native-vision-camera-worklets` `^5.0.0`
+- iOS 11.0 or later
 - react-native-vision-camera-face-detector (optional, for enhanced features)
 
 ## 📦 Installation
@@ -38,12 +40,31 @@ yarn add react-native-vision-camera-spoof-detector
 ### Step 2: Install peer dependencies
 
 ```bash
-npm install react-native-vision-camera react-native-reanimated react-native-worklets-core
+npm install react-native-vision-camera react-native-reanimated react-native-worklets react-native-vision-camera-worklets
 # or
-yarn add react-native-vision-camera react-native-reanimated react-native-worklets-core
+yarn add react-native-vision-camera react-native-reanimated react-native-worklets react-native-vision-camera-worklets
 ```
 
-### Step 3: Configure Android (if not auto-linked)
+### Step 3: Configure iOS
+
+Install the CocoaPods dependencies from the iOS directory:
+
+```bash
+cd ios
+pod install
+cd ..
+```
+
+Add a camera usage description to `ios/<YourApp>/Info.plist`:
+
+```xml
+<key>NSCameraUsageDescription</key>
+<string>This app uses the camera for face liveness verification.</string>
+```
+
+Open the generated `.xcworkspace` in Xcode, or run the app with the React Native CLI. The package pod bundles `FaceAntiSpoofing.tflite` and declares its `TensorFlowLiteSwift` and `VisionCamera` dependencies automatically. No manual model copy is required.
+
+### Step 4: Configure Android (if not auto-linked)
 
 Add to `android/app/build.gradle`:
 
@@ -53,7 +74,7 @@ dependencies {
 }
 ```
 
-### Step 4: Link native module (for React Native < 0.60)
+### Step 5: Link native module (for React Native < 0.60)
 
 ```bash
 react-native link react-native-vision-camera-spoof-detector
@@ -61,24 +82,31 @@ react-native link react-native-vision-camera-spoof-detector
 
 ## 🚀 Quick Start
 
+> **Important:** Request camera permission before rendering `Camera`, and call `initializeFaceAntiSpoof()` once before the frame processor starts. The frame processor returns `null` until native initialization or a result is available. Native inference is throttled and may return the most recent result while another frame is being processed.
+
 ### Simple Usage
 
 ```javascript
 import React, { useEffect, useState } from 'react';
 import { StyleSheet, Text, View } from 'react-native';
-import { Camera, useCameraDevices, useFrameProcessor } from 'react-native-vision-camera';
+import { Camera, useCameraDevices, useCameraPermission, useFrameProcessor } from 'react-native-vision-camera';
 import { faceAntiSpoofFrameProcessor, initializeFaceAntiSpoof } from 'react-native-vision-camera-spoof-detector';
 import { runOnJS } from 'react-native-reanimated';
 
 export default function App() {
   const devices = useCameraDevices();
   const device = devices.front;
+  const { hasPermission, requestPermission } = useCameraPermission();
   const [spoofResult, setSpoofResult] = useState(null);
 
   useEffect(() => {
-    initializeFaceAntiSpoof().then((success) => {
-      console.log('FaceAntiSpoof initialized:', success);
-    });
+    if (!hasPermission) requestPermission();
+  }, [hasPermission, requestPermission]);
+
+  useEffect(() => {
+    initializeFaceAntiSpoof()
+      .then((success) => console.log('FaceAntiSpoof initialized:', success))
+      .catch((error) => console.error('FaceAntiSpoof initialization failed:', error));
   }, []);
 
   const frameProcessor = useFrameProcessor((frame) => {
@@ -89,7 +117,7 @@ export default function App() {
     }
   }, []);
 
-  if (device == null) return <Text>Loading...</Text>;
+  if (!hasPermission || device == null) return <Text>Waiting for camera permission...</Text>;
 
   return (
     <View style={styles.container}>
@@ -140,7 +168,7 @@ const styles = StyleSheet.create({
 
 ```javascript
 import { useCallback, useMemo, useEffect, useRef } from 'react';
-import { Worklets } from 'react-native-worklets-core';
+import { scheduleOnRN } from 'react-native-worklets';
 import { useFrameProcessor } from 'react-native-vision-camera';
 import { useFaceDetector } from 'react-native-vision-camera-face-detector';
 import {
@@ -292,14 +320,14 @@ const result = faceAntiSpoofFrameProcessor(frame);
 
 **Parameters**: `frame` (Vision Camera Frame)
 
-**Returns**: `FaceAntiSpoofingResult | null`
+**Returns**: `FaceAntiSpoofingResult | null`. On iOS, inference runs off the frame callback and the returned object can be the latest completed result.
 
 ### `FaceAntiSpoofingResult`
 
 ```typescript
 interface FaceAntiSpoofingResult {
   isLive: boolean;              // Real face (true) or spoof (false)
-  label: string;                // "Live Face" or "Spoof Face"
+  label: string;                // Usually "live", "spoof", or "error"
   neuralNetworkScore: number;   // 0.0-1.0 confidence
   laplacianScore: number;       // Image quality score
   combinedScore: number;        // Weighted average
@@ -331,11 +359,7 @@ const FACE_CENTER_THRESHOLD_Y = 0.15;         // Y-axis tolerance
 
 ## 🎮 Complete Examples
 
-Check the [examples](./examples) folder for:
-- Basic anti-spoofing detection
-- Face detection with liveness
-- Complete capture flow
-- UI components and feedback
+The [Quick Start](#-quick-start) above shows the basic frame-processor integration. For the complete capture flow, face detection, liveness, and UI patterns, see the [project wiki](https://github.com/dpraful/react-native-vision-camera-spoof-detector/wiki).
 
 ## 🔍 Attack Detection Capabilities
 
@@ -363,8 +387,8 @@ Performance depends on:
 
 | Platform | Status | GPU | Notes |
 |----------|--------|-----|-------|
-| Android  | ✅ Supported | Yes | Fully optimized |
-| iOS      | ⏳ In Progress | Yes | Coming soon |
+| Android  | ✅ Supported | Yes | TensorFlow Lite model bundled in the AAR |
+| iOS      | ✅ Supported | CPU | Requires CocoaPods and iOS 11+ |
 | Web      | ❌ No | N/A | Not applicable |
 
 ## 🐛 Troubleshooting
@@ -377,11 +401,15 @@ if (!available) {
 }
 ```
 
+- iOS: run `pod install` from the `ios` directory and rebuild the app from the generated workspace.
+- iOS: verify `NSCameraUsageDescription` exists in the app's `Info.plist`.
+- Check the initialization promise result and inspect the native logs for model-loading errors.
+
 **Low accuracy**
 - Check lighting conditions
 - Ensure face is centered
 - Adjust `antispooflevel` parameter
-- Verify TensorFlow Lite models are bundled
+- Verify the `FaceAntiSpoofing.tflite` model is bundled (the package does this automatically on iOS)
 
 **Performance issues**
 - Reduce frame processing frequency
@@ -397,10 +425,9 @@ if (!available) {
 
 ## 📖 Documentation
 
-- [Complete API Documentation](./.docs/API.md)
-- [Migration Guide](./.docs/MIGRATION.md)
-- [Best Practices](./.docs/BEST_PRACTICES.md)
-- [Comprehensive Example](./examples/CompleteExampleApp.tsx)
+- [Project Wiki](https://github.com/dpraful/react-native-vision-camera-spoof-detector/wiki)
+- [Changelog](./CHANGELOG.md)
+- [Contributing Guide](./CONTRIBUTING.md)
 
 ## 🤝 Contributing
 

package/android/build.gradle

@@ -130,10 +130,8 @@ dependencies {
     // AndroidX - EXIF Support for image orientation
     implementation "androidx.exifinterface:exifinterface:1.3.6"
 
-    // Vision Camera + Worklets
+    // VisionCamera 5 uses Nitro frame outputs backed by react-native-worklets.
     implementation project(':react-native-vision-camera')
-    implementation project(':react-native-worklets-core')
-
-    // Optional: Face Detector if needed
-    implementation project(':react-native-vision-camera-face-detector')
+    implementation project(':react-native-vision-camera-worklets')
+    implementation project(':react-native-worklets')
 }

package/android/src/main/java/com/faceantispoof/FaceAntiSpoofModule.kt

@@ -4,6 +4,8 @@ import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.bridge.ReactContextBaseJavaModule
 import com.facebook.react.bridge.ReactMethod
 import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.ReadableArray
 import com.facebook.react.module.annotations.ReactModule
 
 @ReactModule(name = FaceAntiSpoofModule.NAME)
@@ -126,6 +128,59 @@ class FaceAntiSpoofModule(reactContext: ReactApplicationContext) : ReactContextB
         }
     }
 
+    @ReactMethod
+    fun processFrame(
+        frameData: ReadableArray,
+        width: Int,
+        height: Int,
+        rowStrides: ReadableArray,
+        pixelStrides: ReadableArray,
+        promise: Promise
+    ) {
+        try {
+            if (frameData.size() < 3 || rowStrides.size() < 3 || pixelStrides.size() < 3) {
+                promise.reject("INVALID_FRAME", "Expected Y, U and V camera planes")
+                return
+            }
+
+            if (!isModuleInitialized || faceAntiSpoofing == null) {
+                promise.reject("NOT_INITIALIZED", "Face anti-spoofing is not initialized")
+                return
+            }
+
+            val planes = Array(3) { planeIndex ->
+                val plane = frameData.getArray(planeIndex)
+                    ?: throw IllegalArgumentException("Camera plane $planeIndex is null")
+                ByteArray(plane.size()) { index -> plane.getInt(index).toByte() }
+            }
+            val yuvRowStrides = IntArray(3) { rowStrides.getDouble(it).toInt() }
+            val yuvPixelStrides = IntArray(3) { pixelStrides.getDouble(it).toInt().coerceAtLeast(1) }
+            val result = faceAntiSpoofing!!.advancedAntiSpoofing(
+                planes,
+                width,
+                height,
+                yuvRowStrides,
+                yuvPixelStrides
+            )
+            val isLive = result.neuralNetworkScore < FaceAntiSpoofingAdvanced.BASE_THRESHOLD &&
+                result.laplacianScore > FaceAntiSpoofingAdvanced.LAPLACIAN_THRESHOLD
+            promise.resolve(
+                Arguments.makeNativeMap(
+                    mapOf(
+                        "isLive" to isLive,
+                        "label" to if (isLive) "Live Face" else "Spoof Face",
+                        "neuralNetworkScore" to result.neuralNetworkScore.toDouble(),
+                        "laplacianScore" to result.laplacianScore,
+                        "combinedScore" to result.combinedScore.toDouble(),
+                        "confidence" to result.confidence.toDouble()
+                    )
+                )
+            )
+        } catch (e: Exception) {
+            promise.reject("PROCESS_ERROR", "Failed to process camera frame", e)
+        }
+    }
+
     @ReactMethod
     fun isAvailable(promise: Promise) {
         try {

package/android/src/main/java/com/faceantispoof/FaceAntiSpoofPackage.kt

@@ -4,32 +4,10 @@ import com.facebook.react.ReactPackage
 import com.facebook.react.bridge.NativeModule
 import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.uimanager.ViewManager
-import com.mrousavy.camera.frameprocessors.FrameProcessorPluginRegistry
 
 class FaceAntiSpoofPackage : ReactPackage {
-
-    companion object {
-        init {
-            try {
-                FrameProcessorPluginRegistry.addFrameProcessorPlugin("faceAntiSpoof") { proxy, options ->
-                    val plugin = FaceAntiSpoofFrameProcessor()
-                    try {
-                        plugin.initialize(proxy.context.assets)
-                    } catch (e: Exception) {
-                        android.util.Log.e("FaceAntiSpoof", "Failed to initialize plugin with assets", e)
-                    }
-                    plugin
-                }
-            } catch (e: Exception) {
-                android.util.Log.e("FaceAntiSpoof", "Plugin already registered or failed: ${e.message}", e)
-            }
-        }
-    }
-
-    override fun createNativeModules(reactContext: ReactApplicationContext): List<NativeModule> {
-        // Only return the module — DO NOT register plugin here.
-        return listOf(FaceAntiSpoofModule(reactContext))
-    }
+    override fun createNativeModules(reactContext: ReactApplicationContext): List<NativeModule> =
+        listOf(FaceAntiSpoofModule(reactContext))
 
     override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> {
         return emptyList()

package/android/src/main/java/com/faceantispoof/FaceAntiSpoofingAdvanced.kt

@@ -24,7 +24,7 @@ class FaceAntiSpoofingAdvanced(private val assetManager: AssetManager) {
         const val BASE_THRESHOLD = 0.2f
         const val ROUTE_INDEX = 6
         const val LAPLACE_THRESHOLD = 50
-        const val LAPLACIAN_THRESHOLD = 4000  // Increased from 1000 - real faces have ~3500+ laplacian score
+        const val LAPLACIAN_THRESHOLD = 1000
         const val MODEL_FILE = "FaceAntiSpoofing.tflite"
         private const val TAG = "FaceAntiSpoofing"
         
@@ -165,6 +165,25 @@ class FaceAntiSpoofingAdvanced(private val assetManager: AssetManager) {
         }
     }
 
+    fun advancedAntiSpoofing(
+        planes: Array<ByteArray>,
+        width: Int,
+        height: Int,
+        rowStrides: IntArray,
+        pixelStrides: IntArray
+    ): AntiSpoofingResult {
+        if (planes.size < 3) {
+            throw IllegalArgumentException("Expected Y, U and V planes")
+        }
+
+        val bitmap = yuv420ToBitmap(planes, width, height, rowStrides, pixelStrides)
+        return try {
+            runBlocking { advancedAntiSpoofing(bitmap).getOrThrow() }
+        } finally {
+            bitmap.recycle()
+        }
+    }
+
     // FROM WORKING VERSION: neuralNetworkAntiSpoofing with Bitmap
     private fun neuralNetworkAntiSpoofing(bitmap: Bitmap): Result<Float> {
         return try {
@@ -365,6 +384,44 @@ class FaceAntiSpoofingAdvanced(private val assetManager: AssetManager) {
         return bitmap
     }
 
+    private fun yuv420ToBitmap(
+        planes: Array<ByteArray>,
+        width: Int,
+        height: Int,
+        rowStrides: IntArray,
+        pixelStrides: IntArray
+    ): Bitmap {
+        val pixels = IntArray(width * height)
+        val yPlane = planes[0]
+        val uPlane = planes[1]
+        val vPlane = planes[2]
+
+        fun sample(plane: ByteArray, row: Int, column: Int, rowStride: Int, pixelStride: Int): Int {
+            val index = row * rowStride + column * pixelStride
+            return if (index in plane.indices) plane[index].toInt() and 0xFF else 128
+        }
+
+        for (y in 0 until height) {
+            for (x in 0 until width) {
+                val yValue = sample(yPlane, y, x, rowStrides[0], pixelStrides[0])
+                val chromaRow = y / 2
+                val chromaColumn = x / 2
+                val uValue = sample(uPlane, chromaRow, chromaColumn, rowStrides[1], pixelStrides[1]) - 128
+                val vValue = sample(vPlane, chromaRow, chromaColumn, rowStrides[2], pixelStrides[2]) - 128
+
+                val red = (yValue + 1.402f * vValue).coerceIn(0f, 255f).toInt()
+                val green = (yValue - 0.344f * uValue - 0.714f * vValue).coerceIn(0f, 255f).toInt()
+                val blue = (yValue + 1.772f * uValue).coerceIn(0f, 255f).toInt()
+                pixels[y * width + x] = (0xFF shl 24) or
+                    (red shl 16) or
+                    (green shl 8) or
+                    blue
+            }
+        }
+
+        return Bitmap.createBitmap(pixels, width, height, Bitmap.Config.ARGB_8888)
+    }
+
     @Throws(IOException::class)
     private fun loadModelFile(assetManager: AssetManager, modelName: String): MappedByteBuffer {
         return try {

package/index.d.ts

@@ -4,7 +4,7 @@
  * TypeScript type definitions
  */
 
-import type { Frame, FrameProcessor } from 'react-native-vision-camera';
+import type { CameraFrameOutput, Frame, FrameOutputOptions, FrameProcessor } from 'react-native-vision-camera';
 import type { SharedValue } from 'react-native-reanimated';
 
 // ============================================================================
@@ -281,6 +281,19 @@ export interface UseFaceDetectionFrameProcessorReturn {
   antiSpoofState: AntiSpoofState;
 }
 
+/**
+ * VisionCamera 5 frame-output options for spoof detection.
+ * The callback runs on the React Native runtime after native inference.
+ */
+export interface UseFaceAntiSpoofFrameOutputOptions extends Partial<FrameOutputOptions> {
+  onResult?: (result: FaceAntiSpoofingResult) => void;
+}
+
+/** Create a VisionCamera 5 frame output backed by the native detector. */
+export function useFaceAntiSpoofFrameOutput(
+  options?: UseFaceAntiSpoofFrameOutputOptions,
+): CameraFrameOutput;
+
 // ============================================================================
 // Module Functions
 // ============================================================================

package/index.js

@@ -1,60 +1,50 @@
 import { NativeModules } from 'react-native';
-import { VisionCameraProxy } from 'react-native-vision-camera';
+import { useFrameOutput } from 'react-native-vision-camera';
+import { scheduleOnRN } from 'react-native-worklets';
 
 const { FaceAntiSpoof } = NativeModules;
 
-// Initialize the plugin before any worklet captures this module.
-let _faceAntiSpoofPlugin = null;
-
-try {
-  _faceAntiSpoofPlugin = VisionCameraProxy.initFrameProcessorPlugin('faceAntiSpoof', {});
-} catch (e) {
-  console.warn('[FaceAntiSpoof] Failed to init frame processor plugin:', e);
-}
+const processFrameOnRN = (frameData, width, height, onResult) => {
+  FaceAntiSpoof.processFrame(frameData.planes, width, height, frameData.rowStrides, frameData.pixelStrides)
+    .then(onResult)
+    .catch((error) => console.error('[FaceAntiSpoof] Frame processing failed:', error));
+};
 
-function ensurePluginInitialized() {
-  if (!_faceAntiSpoofPlugin) {
+export const useFaceAntiSpoofFrameOutput = ({ onResult, ...options } = {}) => {
+  const onFrame = (frame) => {
+    'worklet';
     try {
-      _faceAntiSpoofPlugin = VisionCameraProxy.initFrameProcessorPlugin('faceAntiSpoof', {});
-    } catch (e) {
-      console.warn('[FaceAntiSpoof] Failed to init frame processor plugin:', e);
-      _faceAntiSpoofPlugin = null;
+      const planes = frame.getPlanes();
+      if (planes.length < 3) return;
+
+      const planeData = planes.map((plane) => Array.from(new Uint8Array(plane.getPixelBuffer())));
+      const rowStrides = planes.map((plane) => plane.bytesPerRow);
+      const pixelStrides = planes.map((plane) => plane.bytesPerRow / plane.width);
+      scheduleOnRN(
+        processFrameOnRN,
+        { planes: planeData, rowStrides, pixelStrides },
+        frame.width,
+        frame.height,
+        onResult,
+      );
+    } finally {
+      frame.dispose();
     }
-  }
-  return !!_faceAntiSpoofPlugin;
-}
+  };
 
-// Worklet called by VisionCamera
-export const faceAntiSpoofFrameProcessor = function (frame) {
+  return useFrameOutput({
+    ...options,
+    pixelFormat: 'yuv',
+    targetResolution: { width: 256, height: 256 },
+    onFrame,
+  });
+};
+
+// Kept as a named export for source compatibility. VisionCamera 5 applications
+// must use useFaceAntiSpoofFrameOutput because the old plugin API was removed.
+export const faceAntiSpoofFrameProcessor = function () {
   'worklet';
-  try {
-    if (!_faceAntiSpoofPlugin) {
-      console.warn('[FaceAntiSpoof] Plugin not initialized');
-      return null;
-    }
-    
-    if (typeof _faceAntiSpoofPlugin.call !== 'function') {
-      console.warn('[FaceAntiSpoof] Plugin call method not available');
-      return null;
-    }
-    
-    if (!frame) {
-      console.warn('[FaceAntiSpoof] Frame is null or undefined');
-      return null;
-    }
-    
-    const result = _faceAntiSpoofPlugin.call(frame);
-    
-    // Validate result structure
-    if (result && typeof result === 'object') {
-      return result;
-    }
-    
-    return null;
-  } catch (err) {
-    console.error('[FaceAntiSpoof] Error in frame processor:', err);
-    return null;
-  }
+  return null;
 };
 
 export default FaceAntiSpoof;
@@ -86,9 +76,7 @@ export const initializeFaceAntiSpoof = async () => {
     }
 
     const isSuccess = result && status.pluginAvailable;
-    // If native initialization succeeded, register the frame processor plugin for worklets
-    const pluginInitialized = isSuccess ? ensurePluginInitialized() : false;
-    const initialized = isSuccess && pluginInitialized;
+    const initialized = isSuccess;
     console.log('[FaceAntiSpoof] Initialization result:', initialized);
     return initialized;
   } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-vision-camera-spoof-detector",
-  "version": "1.0.27",
+  "version": "1.1.0",
   "description": "High-performance face anti-spoofing and liveness detection module for React Native Vision Camera. Uses TensorFlow Lite with GPU acceleration and optimized YUV processing.",
   "homepage": "https://github.com/dpraful/react-native-vision-camera-spoof-detector",
   "repository": {
@@ -10,7 +10,7 @@
   "bugs": {
     "url": "https://github.com/dpraful/react-native-vision-camera-spoof-detector/issues"
   },
-  "license": "JSCON TECHNOLOGIES PVT LTD",
+  "license": "MIT",
   "author": {
     "name": "PRAFULDAS M M",
     "company": "JESCON TECHNOLOGIES PVT LTD",
@@ -29,11 +29,7 @@
   "files": [
     "android/",
     "ios/",
-    ".gitattributes",
-    ".gitignore",
-    ".npmignore",
     "CHANGELOG.md",
-    "CONTRIBUTING.md",
     "index.js",
     "index.d.ts",
     "README.md",
@@ -62,7 +58,8 @@
     "react-native": ">=0.60.0",
     "react-native-vision-camera": "^4.6.4 || ^5.0.0",
     "react-native-reanimated": "^3.0.0",
-    "react-native-worklets-core": "^1.0.0"
+    "react-native-vision-camera-worklets": "^5.0.0",
+    "react-native-worklets": "^0.12.0"
   },
   "peerDependenciesMeta": {
     "react-native-vision-camera-face-detector": {

package/react-native-vision-camera-spoof-detector.podspec

@@ -1,10 +1,10 @@
 Pod::Spec.new do |s|
   s.name             = 'react-native-vision-camera-spoof-detector'
-  s.version          = '0.1.0'
+  s.version          = '1.1.0'
   s.summary          = 'Face anti-spoof detector for VisionCamera (iOS)'
-  s.homepage         = 'https://example.com'
-  s.license          = { :type => 'MIT' }
-  s.authors          = { 'You' => 'you@example.com' }
+  s.homepage         = 'https://github.com/dpraful/react-native-vision-camera-spoof-detector'
+  s.license          = { :type => 'MIT', :file => 'LICENSE' }
+  s.authors          = { 'JESCON TECHNOLOGIES PVT LTD' => 'jescontechnologies@gmail.com' }
   s.platform     = :ios, '11.0'
   s.source       = { :path => '.' }
 

package/.gitattributes

@@ -1,2 +0,0 @@
-# Auto detect text files and perform LF normalization
-* text=auto

package/.npmignore

@@ -1,99 +0,0 @@
-# npm ignore patterns - files that should not be published to npm
-
-# Development files
-.git
-.gitignore
-.gitattributes
-
-# Development dependencies
-node_modules
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-
-# IDE / Editor files
-.vscode
-.idea
-.DS_Store
-*.swp
-*.swo
-*~
-.env
-.env.local
-
-# Build artifacts and temporary files
-build/
-dist/
-.rollup.cache/
-.eslintcache
-*.tsbuildinfo
-
-# Android build artifacts and caches
-android/build/
-android/.gradle/
-android/.kotlin/
-android/*.log
-*.apk
-*.aar
-*.so
-
-# Testing
-__tests__
-__mocks__
-*.test.ts
-*.test.tsx
-*.spec.ts
-*.spec.tsx
-coverage
-.jest
-
-# Documentation (optional - remove if you want to publish docs)
-docs/*.md
-.docs/
-
-# Example files (optional - remove if you want to include examples)
-example/
-examples/
-demo/
-
-# CI/CD
-.github/workflows
-.gitlab-ci.yml
-.travis.yml
-azure-pipelines.yml
-
-# Root level files
-.prettierrc
-.prettierignore
-.eslintrc
-.eslintignore
-.babelrc
-tsconfig.json
-jest.config.js
-babel.config.js
-webpack.config.js
-Makefile
-
-# Contribution files
-CONTRIBUTING.md
-CODE_OF_CONDUCT.md
-PULL_REQUEST_TEMPLATE.md
-
-# Misc
-*.map
-.npmrc
-.yarnrc
-.DS_Store
-Thumbs.db
-*.lock
-package-lock.json
-yarn.lock
-
-# Keep essential files
-!android/
-!index.js
-!index.d.ts
-!README.md
-!CHANGELOG.md
-!LICENSE
-!package.json