Eve library

@aphrodite/mobile-viewer — Native Scaffolding Status

Other

Revision 1

On this page

Status: TypeScript-only as of 2026-05-28. The native iOS / Android projects required to actually run this app have not been generated. Closes #62.

What's present#

  • src/App.tsx and screen / navigation / service code that imports React Native modules
  • src/native/ with bridge interfaces (BackgroundImageBridge, DepthEstimationBridge, FaceTrackingBridge, etc.) that target the React Native New Architecture (TurboModules)
  • package.json declares react-native + Detox e2e scripts

What's missing#

  • ios/ directory with Xcode project (.xcodeproj or .xcworkspace), Podfile, Info.plist, AppDelegate.mm
  • android/ directory with Gradle wrapper, build.gradle (root + app), AndroidManifest.xml, MainActivity.kt, MainApplication.kt
  • Root index.js registering the app via AppRegistry
  • metro.config.js for the bundler
  • babel.config.js for the RN preset

Running pnpm android or pnpm ios currently fails because react-native-cli cannot find the platform directories.

How to scaffold#

The recommended path is to run npx @react-native-community/cli init against a sibling temporary directory at the same RN version this package targets (catalog), then port the src/ files in. Do NOT use expo prebuild here — this app intentionally targets bare RN to expose the native bridges in src/native/.

bash
# from repo root
RN_VERSION="$(node -e "console.log(require('./apps/aphrodite/mobile-viewer/package.json').dependencies['react-native'])")"
npx @react-native-community/cli@latest init AphroditeMobileViewer --version $RN_VERSION --directory /tmp/aphro-mv-scaffold
cp -r /tmp/aphro-mv-scaffold/ios apps/aphrodite/mobile-viewer/
cp -r /tmp/aphro-mv-scaffold/android apps/aphrodite/mobile-viewer/
cp /tmp/aphro-mv-scaffold/index.js apps/aphrodite/mobile-viewer/
cp /tmp/aphro-mv-scaffold/metro.config.js apps/aphrodite/mobile-viewer/
cp /tmp/aphro-mv-scaffold/babel.config.js apps/aphrodite/mobile-viewer/
rm -rf /tmp/aphro-mv-scaffold

After porting, update each native project's bundle ID + display name and re-run scripts/check-ios-toolchain.sh (see docs/runbooks/ios-toolchain.md) to confirm the toolchain is ready to build.

Until scaffolding lands#

  • pnpm typecheck and pnpm test are the only working dev loops here. The codebase is treated as a TypeScript module that will later be linked into the native shell.
  • CI should not run pnpm android / pnpm ios for this package. The smoke build workflow (mobile-build-smoke.yml) targets veritas/mobile because it's the canonical mobile fixture.
  • Do not delete src/native/*Bridge.ts files — they pin the TurboModule contract that the native scaffolding will eventually implement.