# iOS App Store Review Checklist

This checklist ensures Tara meets all Apple App Store requirements before
submission.

## Table of Contents

1. [App Store Guidelines Compliance](#app-store-guidelines-compliance)
2. [In-App Purchases](#in-app-purchases)
3. [Privacy & Data](#privacy--data)
4. [Technical Requirements](#technical-requirements)
5. [App Store Listing](#app-store-listing)
6. [Submission Checklist](#submission-checklist)

---

## App Store Guidelines Compliance

### Safety (Section 1)

- [ ] **1.1 Objectionable Content**: No objectionable content in app or metadata
- [ ] **1.2 User-Generated Content**: UGC moderation implemented (if applicable)
- [ ] **1.3 Kids Category**: Not applicable (not targeting children)
- [ ] **1.4 Physical Harm**: Health disclaimers present, crisis resources
      available
- [ ] **1.5 Developer Information**: Contact information accurate and reachable
- [ ] **1.6 Data Security**: User data encrypted, secure connections used

### Performance (Section 2)

- [x] **2.1 App Completeness**: No placeholder content, all features functional
- [ ] **2.2 Beta Testing**: TestFlight builds removed before submission
- [ ] **2.3 Accurate Metadata**: Description matches app functionality
- [ ] **2.4 Hardware Compatibility**: Tested on supported devices
- [ ] **2.5 Software Requirements**: Minimum iOS version appropriate

### Business (Section 3)

- [ ] **3.1.1 In-App Purchase**: Uses StoreKit for all digital purchases
- [ ] **3.1.2 Subscriptions**: Auto-renewable subscriptions properly implemented
- [ ] **3.1.3 Other Purchase Methods**: No links to external payment
- [ ] **3.2 Other Business Model Issues**: No manipulative practices

### Design (Section 4)

- [ ] **4.1 Copycats**: Original design, not copying other apps
- [ ] **4.2 Minimum Functionality**: App provides sufficient value
- [ ] **4.3 Spam**: No duplicate content or keyword stuffing
- [ ] **4.4 Extensions**: N/A unless using extensions
- [ ] **4.5 Apple Sites and Services**: Sign in with Apple implemented (if
      social login used)
- [ ] **4.6 Alternate App Icons**: N/A unless using alternate icons
- [ ] **4.7 HTML5 Games/Apps**: N/A

### Legal (Section 5)

- [ ] **5.1 Privacy**: Privacy policy URL valid and content accurate
- [ ] **5.2 Intellectual Property**: All content properly licensed
- [ ] **5.3 Gaming/Gambling**: N/A (not a gambling app)
- [ ] **5.4 VPN Apps**: N/A
- [ ] **5.5 Mobile Device Management**: N/A

---

## In-App Purchases

### StoreKit Implementation

- [ ] Uses StoreKit 2 API (recommended) or StoreKit 1
- [ ] Products configured in App Store Connect
- [ ] Product IDs match between app and App Store Connect
- [ ] Receipt validation implemented (server-side recommended)
- [ ] Graceful handling of purchase failures

### Subscription Requirements

- [ ] Auto-renewable subscription type used for premium access
- [ ] Free trial period clearly disclosed
- [ ] Subscription management link provided in app
- [ ] Easy-to-find cancellation instructions
- [ ] Price displayed before purchase confirmation
- [ ] Subscription terms displayed in app

### Subscription Terms (Required Copy)

```
[SUBSCRIPTION NAME] subscription includes:
- [Feature 1]
- [Feature 2]
- [Feature 3]

Payment will be charged to your Apple ID account at confirmation of purchase.
Subscription automatically renews unless canceled at least 24 hours before
the end of the current period. Your account will be charged for renewal
within 24 hours prior to the end of the current period.

You can manage and cancel your subscriptions by going to your Account
Settings on the App Store after purchase.

Privacy Policy: [URL]
Terms of Service: [URL]
```

- [ ] Above terms displayed on subscription screen
- [ ] Terms visible without scrolling (above the fold)

### Restore Purchases

- [ ] "Restore Purchases" button visible and functional
- [ ] Works for users who reinstall the app
- [ ] Works for users on new devices
- [ ] Proper error handling for restore failures

---

## Privacy & Data

### Privacy Policy

- [ ] Privacy policy URL in App Store Connect
- [ ] Privacy policy accessible in-app
- [ ] Privacy policy describes all data collection
- [ ] Privacy policy describes third-party sharing
- [ ] Privacy policy includes contact information

### App Privacy Labels (Privacy Nutrition Labels)

Configure in App Store Connect:

#### Data Used to Track You

- [ ] Accurate list of tracking data (likely none for Tara)

#### Data Linked to You

- [ ] Contact Info (email for account)
- [ ] Health & Fitness (meditation usage)
- [ ] User Content (preferences)
- [ ] Usage Data (app analytics)
- [ ] Identifiers (user ID)

#### Data Not Linked to You

- [ ] Crash data (if collected anonymously)
- [ ] Performance data (if collected anonymously)

### App Tracking Transparency (ATT)

- [ ] ATT prompt implemented if tracking users (iOS 14.5+)
- [ ] App functions without tracking consent
- [ ] Tracking disabled if user denies permission
- [ ] Purpose string explains why tracking is needed

### Sign in with Apple

If social login is offered:

- [ ] Sign in with Apple as an option
- [ ] Same prominence as other login options
- [ ] Works alongside other authentication methods
- [ ] Account can be created with just Apple ID

---

## Technical Requirements

### iOS Version Support

- [ ] Minimum iOS version: iOS 15.0 (recommended)
- [ ] Tested on minimum supported version
- [ ] Uses iOS SDK features appropriately

### Device Support

- [ ] iPhone support (required)
- [ ] iPad support (recommended)
- [ ] Proper Auto Layout for all screen sizes
- [ ] Safe area insets respected
- [ ] Notch and Dynamic Island handled

### Performance Requirements

- [ ] App launches in under 5 seconds
- [ ] Smooth scrolling (60fps)
- [ ] No memory leaks
- [ ] Background audio works correctly
- [ ] Battery usage reasonable
- [ ] Network calls efficient

### App Capabilities

Required entitlements configured:

- [ ] Push Notifications
- [ ] Background Audio
- [ ] In-App Purchases
- [ ] HealthKit (if syncing meditation data)

### Crash-Free

- [ ] No crashes in normal usage
- [ ] Graceful handling of edge cases
- [ ] Error states have recovery paths
- [ ] Network failures handled gracefully

---

## App Store Listing

### App Information

- [ ] App name (30 characters max)
- [ ] Subtitle (30 characters max)
- [ ] Category: Health & Fitness (primary)
- [ ] Secondary category (optional): Lifestyle
- [ ] Content rating: 4+
- [ ] Age rating questionnaire accurate

### App Description

- [ ] Description compelling and accurate
- [ ] No competitor mentions
- [ ] No pricing information (auto-updated by Apple)
- [ ] Keywords optimized (100 characters)
- [ ] What's New section updated

### Screenshots

Required screenshots:

- [ ] 6.7" iPhone (1290x2796 or 2796x1290)
- [ ] 6.5" iPhone (1284x2778 or 2778x1284)
- [ ] 5.5" iPhone (1242x2208 or 2208x1242)
- [ ] 12.9" iPad Pro (2048x2732 or 2732x2048)

Screenshot requirements:

- [ ] Accurate representation of app
- [ ] No device frames required (optional)
- [ ] No excessive text overlay
- [ ] High quality, not pixelated

### App Preview Videos (Optional)

- [ ] 15-30 seconds
- [ ] Shows actual app footage
- [ ] Appropriate audio (or muted)
- [ ] H.264 codec
- [ ] Proper aspect ratio for device

### App Icon

- [ ] 1024x1024 PNG (no alpha)
- [ ] No screenshots in icon
- [ ] Distinct and recognizable
- [ ] Consistent with app design

---

## Submission Checklist

### Pre-Submission

- [ ] All features tested and working
- [ ] Subscription flows verified in sandbox
- [ ] Privacy policy URL accessible
- [ ] Support URL accessible
- [ ] Marketing URL (optional) accessible
- [ ] Contact information accurate

### App Store Connect Configuration

- [ ] App information complete
- [ ] Pricing and availability set
- [ ] In-app purchases created and approved
- [ ] Privacy labels configured
- [ ] App review information complete
- [ ] Demo account credentials (if needed)

### Build Submission

- [ ] Archive created in Xcode
- [ ] Build uploaded via Xcode or Transporter
- [ ] Build selected in App Store Connect
- [ ] Export compliance configured
- [ ] Content rights confirmed

### Notes for Reviewers

Include in "Notes for Review" field:

- [ ] Demo account credentials
- [ ] Subscription testing instructions
- [ ] Any special testing notes
- [ ] Explanation of any unusual features

### Common Rejection Reasons to Avoid

- [ ] Guideline 2.1 - App does not crash
- [ ] Guideline 2.3 - App matches description
- [ ] Guideline 3.1.1 - Uses In-App Purchase
- [ ] Guideline 4.2 - Has minimum functionality
- [ ] Guideline 5.1.1 - Privacy policy present

---

## Post-Submission

### Monitoring

- [ ] Check App Store Connect daily for review status
- [ ] Respond to reviewer questions promptly
- [ ] Be prepared to submit updated build if needed

### If Rejected

1. Read rejection message carefully
2. Review referenced guidelines
3. Make required changes
4. Reply to rejection with explanation
5. Resubmit for review

---

## Sign-Off

| Reviewer | Role            | Date | Approved |
| -------- | --------------- | ---- | -------- |
|          | iOS Developer   |      | [ ]      |
|          | QA Lead         |      | [ ]      |
|          | Product Manager |      | [ ]      |
|          | Legal           |      | [ ]      |

---

## References

- [App Store Review Guidelines](https://developer.apple.com/app-store/review/guidelines/)
- [App Store Connect Help](https://help.apple.com/app-store-connect/)
- [Human Interface Guidelines](https://developer.apple.com/design/human-interface-guidelines/)
- [StoreKit Documentation](https://developer.apple.com/documentation/storekit)
- [App Privacy Details](https://developer.apple.com/app-store/app-privacy-details/)
