comapeo-core-react-native

Write and run Maestro UI e2e flows for mobile apps locally and in GitHub Actions CI. Covers install, device setup, flow YAML syntax, config.yaml, running/debugging flows, Expo/React Native handling (dev menu & LogBox overlays, testID, dev-client vs release builds), and CI pipelines. Use when the user mentions "Maestro", "maestro test", "maestro flow", ".maestro", "e2e flow", "UI test", or working with files under a `maestro/` or `.maestro/` directory. Local + GitHub CI only — for real-device runs on BrowserStack see the browserstack-app-automate-maestro skill; this skill does NOT cover Maestro Cloud or Maestro Studio.

Run this repo's Android test layers and capture device logs. Covers the `scripts/run-instrumented-tests.sh` runner (single-class filter, --skip-build, --unit-only), the underlying `:comapeo-core-react-native:connectedDebugAndroidTest` Gradle task on the integration app, where the JVM/instrumented/service-lifecycle tests live, the report paths, and how to read logcat for the Kotlin (`ComapeoCore`) and embedded-Node (`Comapeo:NodeJS`) tags including the `:ComapeoCore` foreground-service process. Use when running, filtering, or debugging Android unit/instrumented/androidTest runs, a single Android test class, `connectedDebugAndroidTest`, or `adb logcat` for this project.

Diagnose and fix native (C/C++) Node.js addon loading in this repo's embedded nodejs-mobile runtime — the rolled-up backend's `__loadAddon` helper, Android `jniLibs/lib<name>__<version>.so` (bare-name dlopen from the APK mmap), and iOS `<name>__<version>.xcframework` (Embed & Sign into the .app). Use when a native module fails to load at runtime, when you see `dlopen`, `UnsatisfiedLinkError`, `cannot locate symbol`, `Library not loaded`, `image not found`, `code signature`, a `p_align`/16 KB alignment APK reject, or a prebuild-download/404 from `scripts/build-backend.ts`; or when touching `sodium-native`, `better-sqlite3`, `crc-native`, `quickbit-native`, `rabin-native`, `simdle-native`, `fs-native-extensions`, the rollup addon-loader plugin, `jniLibs`, or `ios/Frameworks`.