# @aphrodite/mobile-viewer — Native Scaffolding Status

**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.
