feat(source-maps): real React Native test apps (bare + Expo) (#2960)

* feat(source-maps): real React Native test apps (bare + Expo)

The wizard is flipping react-native to automatable in the
error-tracking-upload-source-maps program, so the stub fixture that
existed to exercise the unsupported-platform path is replaced with two
real apps, mirroring the ios-pod/ios-spm two-flavour pattern:

- react-native/: bare RN 0.86 scaffold (android/ + ios/ projects) with
  posthog-react-native installed and initialised in App.tsx
- react-native-expo/: Expo SDK 57 blank scaffold with
  posthog-react-native installed and initialised in App.js

Both pre-seed .env with the POSTHOG_CLI_* trio like the android and
ios-spm apps.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* chore(source-maps): strip RN test apps to minimal shells

Drop scaffold extras (README, Gemfile, jest/eslint/prettier configs,
tests, Expo assets/LICENSE/AGENTS.md/CLAUDE.md/.claude) and trim
package.json to what the upload flow needs: PostHog installed, native
projects intact, no source maps configured.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* docs(source-maps): run/build instructions for the RN fixtures

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* fix: reade

* fix: readme

* fix: package locks

* fix: expo prebuilds

* fix: dotenvs ignore

* fix(source-maps): drop mismatched expo-file-system from Expo fixture

~19.0.7 is the SDK 54 line; the app is Expo SDK 57, so the Release
build failed compiling FileSystemLegacyModule.swift against the newer
expo-modules-core Promise API. The fixture doesn't need the package —
posthog-react-native only uses it opportunistically.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* fix: regenerate prebuild

* feat(apps): add native crash triggers to react-native source-map fixtures

Both RN fixtures get a 'Trigger native crash' button backed by a tiny
native module (RuntimeException on Android, NSException on iOS) so native
crash autocapture + symbolication can be verified end to end after a
wizard run. Expo uses a local expo-module (autolinked at prebuild);
bare RN registers a classic bridge module in both native projects.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>

Author: ablaszkiewicz

apps/error-tracking-upload-source-maps/react-native-expo/.gitignore

@@ -0,0 +1,43 @@
+# Learn more https://docs.github.com/en/get-started/getting-started-with-git/ignoring-files
+
+# dependencies
+node_modules/
+
+# Expo
+.expo/
+dist/
+web-build/
+expo-env.d.ts
+
+# Native
+.kotlin/
+*.orig.*
+*.jks
+*.p8
+*.p12
+*.key
+*.mobileprovision
+
+# Metro
+.metro-health-check*
+
+# debug
+npm-debug.*
+yarn-debug.*
+yarn-error.*
+
+# macOS
+.DS_Store
+*.pem
+
+# local env files
+.env*.local
+
+# typescript
+*.tsbuildinfo
+
+# generated native folders
+/ios
+/android
+
+.env

apps/error-tracking-upload-source-maps/react-native-expo/App.js

@@ -0,0 +1,31 @@
+import { StatusBar } from 'expo-status-bar';
+import { PostHogProvider } from 'posthog-react-native';
+import { Button, StyleSheet, Text, View } from 'react-native';
+import NativeCrashTest from './modules/native-crash-test';
+
+export default function App() {
+  return (
+    <PostHogProvider
+      apiKey="phc_raG2H9V246hkNZk6K89DZGG98qQyPrKKlicifGlpOXA"
+      options={{ host: 'https://internal-c.posthog.com' }}
+    >
+      <View style={styles.container}>
+        <Text>Open up App.js to start working on your app!</Text>
+        {/* Crashes the app natively (not a JS error). Only shows up in PostHog
+            error tracking when native crash autocapture is enabled; the crash
+            report uploads on the NEXT app launch. */}
+        <Button title="Trigger native crash" onPress={() => NativeCrashTest.crash()} />
+        <StatusBar style="auto" />
+      </View>
+    </PostHogProvider>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    backgroundColor: '#fff',
+    alignItems: 'center',
+    justifyContent: 'center',
+  },
+});

apps/error-tracking-upload-source-maps/react-native-expo/README.md

@@ -0,0 +1,25 @@
+# Expo source-maps fixture
+
+PostHog SDK installed, no source-map upload configured — run the wizard's
+`upload-source-maps` against this app
+
+## Setup
+
+```bash
+npm install
+```
+
+## Run (dev)
+
+```bash
+npx expo start        # or: npm run android / npm run ios
+```
+
+## Build Release (uploads only fire on Release native builds)
+
+```bash
+npx expo prebuild     # generates android/ and ios/
+
+npx expo run:android --variant release
+npx expo run:ios --configuration Release
+```

apps/error-tracking-upload-source-maps/react-native-expo/app.json

@@ -0,0 +1,16 @@
+{
+  "expo": {
+    "name": "react-native-expo",
+    "slug": "react-native-expo",
+    "version": "1.0.0",
+    "orientation": "portrait",
+    "userInterfaceStyle": "light",
+    "ios": {
+      "supportsTablet": true,
+      "bundleIdentifier": "com.ablaszkiewicz.reactnativeexpo"
+    },
+    "android": {
+      "package": "com.ablaszkiewicz.reactnativeexpo"
+    }
+  }
+}

apps/error-tracking-upload-source-maps/react-native-expo/index.js

@@ -0,0 +1,8 @@
+import { registerRootComponent } from 'expo';
+
+import App from './App';
+
+// registerRootComponent calls AppRegistry.registerComponent('main', () => App);
+// It also ensures that whether you load the app in Expo Go or in a native build,
+// the environment is set up appropriately
+registerRootComponent(App);

apps/error-tracking-upload-source-maps/react-native-expo/modules/native-crash-test/android/build.gradle

@@ -0,0 +1,15 @@
+plugins {
+  id 'com.android.library'
+  id 'expo-module-gradle-plugin'
+}
+
+group = 'expo.modules.nativecrashtest'
+version = '1.0.0'
+
+android {
+  namespace "expo.modules.nativecrashtest"
+  defaultConfig {
+    versionCode 1
+    versionName '1.0.0'
+  }
+}

apps/error-tracking-upload-source-maps/react-native-expo/modules/native-crash-test/android/src/main/java/expo/modules/nativecrashtest/NativeCrashTestModule.kt

@@ -0,0 +1,21 @@
+package expo.modules.nativecrashtest
+
+import android.os.Handler
+import android.os.Looper
+import expo.modules.kotlin.modules.Module
+import expo.modules.kotlin.modules.ModuleDefinition
+
+class NativeCrashTestModule : Module() {
+  override fun definition() = ModuleDefinition {
+    Name("NativeCrashTest")
+
+    // Posts to the main thread so the exception escapes React Native's
+    // native-module call guards and crashes the app as a real uncaught
+    // JVM exception (what PostHog's native crash autocapture records).
+    Function("crash") {
+      Handler(Looper.getMainLooper()).post {
+        throw RuntimeException("PostHog native crash test (Android)")
+      }
+    }
+  }
+}

apps/error-tracking-upload-source-maps/react-native-expo/modules/native-crash-test/expo-module.config.json

@@ -0,0 +1,9 @@
+{
+  "platforms": ["ios", "android"],
+  "ios": {
+    "modules": ["NativeCrashTestModule"]
+  },
+  "android": {
+    "modules": ["expo.modules.nativecrashtest.NativeCrashTestModule"]
+  }
+}

apps/error-tracking-upload-source-maps/react-native-expo/modules/native-crash-test/index.js

@@ -0,0 +1,3 @@
+import { requireNativeModule } from 'expo-modules-core';
+
+export default requireNativeModule('NativeCrashTest');

apps/error-tracking-upload-source-maps/react-native-expo/modules/native-crash-test/ios/NativeCrashTest.podspec

@@ -0,0 +1,19 @@
+Pod::Spec.new do |s|
+  s.name           = 'NativeCrashTest'
+  s.version        = '1.0.0'
+  s.summary        = 'Throws a native crash to verify PostHog symbolication'
+  s.description    = 'Test-only local Expo module: crashes the app natively on demand'
+  s.author         = ''
+  s.homepage       = 'https://docs.expo.dev/modules/'
+  s.platforms      = { :ios => '15.1' }
+  s.source         = { git: '' }
+  s.static_framework = true
+
+  s.dependency 'ExpoModulesCore'
+
+  s.pod_target_xcconfig = {
+    'DEFINES_MODULE' => 'YES',
+  }
+
+  s.source_files = '**/*.{h,m,mm,swift,hpp,cpp}'
+end