findmetester-react-native

Official open-source SDK for FindMeTester — a free, community-driven test exchange platform for Google Play closed testing.

Open source & transparent: This SDK's full source code is available in this repository. It collects only app metadata (package name, version, app icon) — no user data, no tracking, no analytics. All network calls go to findmetester.com/api/sdk/* endpoints.

What does this SDK do?

FindMeTester helps Android developers get 12 testers for Google Play closed testing by exchanging tests with other developers. This SDK verifies that testers keep your app installed for the required 14-day period.

Specifically, it:

1. Registers your app's public metadata (package name, version, icon) with FindMeTester on first launch
2. Sends a daily heartbeat (just the SDK key + package name) to confirm the app is still installed
3. That's it — no personal data, no device IDs, no tracking

Security & Privacy

• No user data collected — only public app metadata (package name, version, icon)
• No device fingerprinting — no IMEI, advertising ID, or device identifiers
• No analytics or tracking — the SDK does not track user behavior
• Minimal permissions — no special Android permissions required
• MIT licensed — review the source code yourself
• Zero dependencies — only peer dependencies you already likely use

Installation

npm install findmetester-react-native

Peer dependencies

npm install @react-native-async-storage/async-storage react-native-device-info react-native-background-fetch

Usage

Call init() once in your app entry point (e.g. App.tsx):

import { FindMeTester } from 'findmetester-react-native';

// Get your SDK key from https://findmetester.com/dashboard
FindMeTester.init('fmt_your_sdk_key');

That's it. The SDK will:

1. Register your app (package name, version, icon) on first launch or version update
2. Send daily heartbeats via background fetch to verify the app stays installed
3. Auto-retry on next app foreground if a heartbeat was missed

How it works

• On init(), the SDK checks if the current app version is already registered. If not, it sends app metadata to FindMeTester.
• A background task runs once per day to confirm the app is still installed.
• All data is stored locally via AsyncStorage. No user data is collected.

Network requests

The SDK makes requests only to these endpoints:

| Endpoint | When | Data sent | |----------|------|-----------| | POST /api/sdk/register | First launch / version update | SDK key, package name, version, app icon | | POST /api/sdk/heartbeat | Once per day | SDK key, package name |

Requirements

• React Native >= 0.68
• Android only (iOS is a no-op)

Native module (optional)

The package includes FindMeTesterIconModule which extracts the app launcher icon as base64. This is auto-linked on Android — no manual setup needed.

Links

• FindMeTester Website
• npm Package
• Report an Issue

License

MIT — see LICENSE for details.