# OSHUN Mobile Store Submission

This directory is the source of truth for the OSHUN V1 App Store Connect and
Google Play Console submission package.

## Contents

- `metadata.json` contains listing copy, categories, screenshot slots, privacy
  labels, permission rationale, and reviewer walkthroughs.
- `compliance.json` maps the submission package to App Store and Play Console
  review requirements.
- `PrivacyInfo.xcprivacy` is synced with the bundled iOS privacy manifest at
  `ios/OSHUN/PrivacyInfo.xcprivacy`.
- `assets/` contains generated store assets:
  - `apple/app-icon-1024.png`
  - `google-play/icon-512.png`
  - `google-play/feature-graphic.png`
- `generated/` is intentionally ignored. It is where final device screenshots
  are captured before upload.

## Commands

```bash
pnpm --dir apps/oshun/mobile run store:assets
pnpm --dir apps/oshun/mobile run store:validate
pnpm --dir apps/oshun/mobile run e2e:captures:store:dry
```

Final screenshots require release-candidate builds on physical devices or store
profile simulators:

```bash
pnpm --dir apps/oshun/mobile run e2e:captures:store
```

The capture flow records eight listing slots for every declared screenshot set:
home continuity, Tara, Veritas, Nyx, Arete, Nisaba, Metis, and assistant
context. Slot IDs, captions, alt text, capture profiles, and output directories
are defined in `metadata.json`.

Supported capture profiles:

- `ios-iphone-6-9`
- `ios-iphone-6-5`
- `ios-ipad-13`
- `ios-all`
- `android-phone`
- `android-tablet-7`
- `android-tablet-10`
- `android-all`
- `all`

## Review Notes

Use the `APP_REVIEW_PASSWORD` secret with `review@oshun.app`; never commit a
plaintext review password. Premium entitlements must be enabled for the review
account before submission.

The store package intentionally discloses optional capture intake permissions:
camera, microphone, motion, photo/video import, and legacy storage access. These
permissions are not needed for normal meditation, study, evidence, or sky flows;
reviewers can trigger them only from the optional mobile capture intake.
