@vyshnav18/react-native-fps-counter 1.0.0

package/README.md

@@ -0,0 +1,101 @@
+# react-native-fps-counter
+
+A high-performance FPS counter for React Native that tracks both **JS thread** and **native UI thread** frame rates using Turbo Modules with JSI for minimal overhead.
+
+## Features
+
+- 📊 **Dual-thread monitoring** - Track both JS and UI thread FPS
+- ⚡ **Maximum performance** - Uses JSI/Turbo Modules for direct native calls
+- 🔄 **Backward compatible** - Works with both new architecture (0.76+) and old bridge
+- 📱 **Cross-platform** - iOS (CADisplayLink) and Android (Choreographer)
+- 🎨 **Customizable** - Flexible styling and display options
+
+## Installation
+
+```bash
+npm install react-native-fps-counter
+# or
+yarn add react-native-fps-counter
+```
+
+### iOS Setup
+
+```bash
+cd ios && pod install
+```
+
+### Android
+
+No additional setup required - auto-linking handles everything.
+
+## Usage
+
+### Basic Usage
+
+```tsx
+import { View } from 'react-native';
+import { FpsCounter } from 'react-native-fps-counter';
+
+export default function App() {
+  return (
+    <View style={{ flex: 1 }}>
+      {/* Your app content */}
+      <FpsCounter />
+    </View>
+  );
+}
+```
+
+### Component Props
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `visible` | `boolean` | `true` | Toggle visibility |
+| `showJsFps` | `boolean` | `true` | Show JS thread FPS |
+| `showUiFps` | `boolean` | `true` | Show UI thread FPS |
+| `showAverage` | `boolean` | `true` | Show average values |
+| `averageDecimalPlaces` | `number` | `1` | Decimal places for averages |
+| `style` | `FpsCounterStyles` | - | Custom styling |
+
+### Using Hooks Directly
+
+```tsx
+import { useFPSMetric, useUIFPSMetric } from 'react-native-fps-counter';
+
+function MyComponent() {
+  // JS thread FPS (no native module required)
+  const { fps: jsFps, average: jsAverage } = useFPSMetric();
+
+  // Native UI thread FPS
+  const { uiFps, uiAverage } = useUIFPSMetric();
+
+  return (
+    <Text>
+      JS: {jsFps} | UI: {uiFps}
+    </Text>
+  );
+}
+```
+
+## How It Works
+
+| Thread | Method | Description |
+|--------|--------|-------------|
+| **JS Thread** | `requestAnimationFrame` | Measures JavaScript execution loop |
+| **UI Thread (iOS)** | `CADisplayLink` | Syncs with display refresh rate |
+| **UI Thread (Android)** | `Choreographer` | Native frame callback system |
+
+## Architecture Support
+
+- ✅ **New Architecture (0.76+)** - Uses Turbo Modules with JSI
+- ✅ **Old Architecture** - Falls back to bridge (same API)
+
+## Tips
+
+1. **Place at root level** - Put `<FpsCounter>` at the root of your app for accurate measurements
+2. **Release builds** - This works in release builds where dev tools aren't available
+3. **Minimal impact** - The native modules have negligible performance overhead
+
+## License
+
+MIT

package/android/.gradle/buildOutputCleanup/cache.properties

@@ -0,0 +1,2 @@
+#Sun Feb 01 14:07:00 IST 2026
+gradle.version=9.2.0