App Store Review Guide for BiteSwipe v1.0

# App Store Review Guide for BiteSwipe v1.0

## 🎯 Goal: First-Time Approval

This guide covers everything needed to pass App Store review on your first submission.

---

## 📋 Pre-Submission Checklist

### 1. **App Completeness**
- [x] All features work without crashing
- [x] No placeholder content or "lorem ipsum" text
- [x] No beta/test labels in the UI
- [x] Remove all console.logs and debug features
- [ ] Test on multiple iOS versions (15.0+)
- [ ] Test on different iPhone sizes

### 2. **Required App Store Connect Information**

#### App Description
```
BiteSwipe - Dining Decisions Made Easy

Swipe right on restaurants you love, left on ones you don't. When dining with friends, everyone swipes and BiteSwipe finds matches everyone agrees on.

Features:
• Discover restaurants near you
• Create groups with friends and family
• Swipe together, match instantly
• See ratings, photos, and details
• Never argue about where to eat again

BiteSwipe Plus:
• Unlimited daily swipes (Free: 20/day)
• Larger groups up to 8 people (Free: 2)
• Ad-free experience
• Priority support

Download now and make dining decisions fun!
```

#### Keywords
```
restaurant, food, dining, group, friends, swipe, match, eat, dinner, lunch
```

#### Support URL
```
https://biteswipe.app/support
```

#### Privacy Policy URL
```
https://biteswipe.app/privacy
```

### 3. **Screenshots Requirements**
- **6.7" (iPhone 14 Pro Max)**: 1290 x 2796 pixels
- **6.5" (iPhone 11 Pro Max)**: 1242 x 2688 pixels
- **5.5" (iPhone 8 Plus)**: 1242 x 2208 pixels

**Screenshot Ideas:**
1. Swiping interface with restaurant cards
2. Group creation screen
3. Match celebration with confetti
4. Restaurant details view
5. Group members list

### 4. **App Review Information**

#### Demo Account
```
Email: [email protected]
Password: AppleReview2024!
```

#### Notes for Reviewer
```
BiteSwipe helps groups decide where to eat through collaborative swiping.

To test the app:
1. Sign in with the demo account provided
2. Allow location permissions to see nearby restaurants
3. Try swiping on restaurants
4. Create a group using the Groups tab
5. The subscription offers 3-day free trial

The app uses location to find restaurants near the user. This is the core functionality and is clearly explained to users.

RevenueCat is used for subscription management.
Google Places API provides restaurant data.
```

---

## 🚫 Common Rejection Reasons & Solutions

### 1. **Guideline 4.3 - Spam**
**Issue**: App appears too similar to existing apps
**Solution**: 
- Emphasize unique GROUP matching feature
- Highlight collaborative decision making
- Show how it's different from Tinder/dating apps

### 2. **Guideline 5.1.1 - Data Collection**
**Issue**: Collecting data without clear purpose
**Our Solution**: 
- ✅ Only collect email, name, location
- ✅ Clear privacy policy
- ✅ Location usage is core functionality
- ✅ All data use is transparent

### 3. **Guideline 3.1.1 - In-App Purchase**
**Issue**: Subscription details not clear
**Our Solution**:
- ✅ Clear pricing in paywall
- ✅ 3-day free trial prominently displayed
- ✅ Terms of use and privacy policy linked
- ✅ Restore purchases button implemented

### 4. **Guideline 2.1 - App Completeness**
**Issue**: Crashes or broken features
**Prevention**:
- Test all flows thoroughly
- Test with no internet connection
- Test location permission denial
- Test subscription purchase flow
- Test with empty restaurant results

### 5. **Guideline 5.1.2 - Location**
**Issue**: Using location without justification
**Our Approach**:
- ✅ Location is CORE to finding restaurants
- ✅ Clear permission request messaging
- ✅ App works (with limitations) if denied
- ✅ No background location usage

---

## 💰 Subscription Setup

### Required in App Store Connect:
1. **Subscription Group**: "BiteSwipe Premium"
2. **Subscriptions**:
   - BiteSwipe Plus (Monthly) - $2.99
   - BiteSwipe Plus (Annual) - $19.99

### Subscription Description:
```
BiteSwipe Plus - Unlimited Dining Discovery

• Unlimited daily swipes (Free users: 20/day)
• Create groups up to 8 people (Free users: 2)
• Ad-free experience
• Priority customer support

Subscription automatically renews unless canceled at least 24 hours before the end of the current period. Manage subscriptions in your Account Settings.
```

### Review Guidelines Text:
```
Title: BiteSwipe Plus
Description: Unlock unlimited swipes and larger groups

This subscription includes:
- Unlimited restaurant swipes per day
- Groups up to 8 members
- Ad-free experience
- Priority support

Price: $2.99/month or $19.99/year
Duration: Auto-renewable
Free Trial: 3 days
```

---

## 📱 TestFlight Best Practices

### Before Submitting to Review:
1. **Run TestFlight beta** for 1-2 weeks
2. **Get 20-50 testers** to use the app
3. **Fix all crashes** reported by TestFlight
4. **Document crash fixes** in review notes

### TestFlight Metadata:
```
What to Test:
- Create groups and invite friends
- Swipe on restaurants in your area
- Try the free trial subscription
- Test with different group sizes
- Report any crashes or issues
```

---

## 🎬 App Preview Video (Optional but Helpful)

**Requirements**: 
- 15-30 seconds
- 1080x1920 pixels
- Show actual app UI

**Script**:
1. 0-5s: "Can't decide where to eat?"
2. 5-10s: Show swiping interface
3. 10-15s: Show group creation
4. 15-20s: Show match celebration
5. 20-25s: "Download BiteSwipe today!"

---

## 🚀 Submission Process

### 1. **Final Testing** (Day -2)
- [ ] Clean install test
- [ ] All features working
- [ ] No debug/test content
- [ ] Subscription flow works

### 2. **Prepare Submission** (Day -1)
- [ ] Take all screenshots
- [ ] Write all descriptions
- [ ] Set up demo account
- [ ] Upload build to App Store Connect

### 3. **Submit for Review** (Day 0)
- [ ] Fill in all metadata
- [ ] Add review notes
- [ ] Submit before Tuesday (faster reviews)
- [ ] Enable "Release Automatically"

### 4. **Monitor Review** (Day 1-3)
- Check email frequently
- Respond to any queries within 24 hours
- Have fixes ready for common issues

---

## 🔧 If Rejected

### Quick Fix List:
1. **Crash**: Fix and resubmit immediately
2. **Metadata**: Update descriptions as requested
3. **Screenshots**: Replace if needed
4. **Demo account**: Ensure it works
5. **Clarification**: Provide detailed response

### Response Template:
```
Dear App Review Team,

Thank you for reviewing BiteSwipe. We have addressed the issue you raised:

[Specific fix description]

We have uploaded a new build [version] that resolves this issue. 

The app helps groups collaboratively decide where to eat, which is a unique social dining experience different from existing apps.

Please let us know if you need any additional information.

Best regards,
The BiteSwipe Team
```

---

## 📞 Emergency Contacts

- **App Review Contact**: Via App Store Connect Resolution Center
- **RevenueCat Support**: [email protected]
- **Expedited Review**: Only for critical issues

---

## ✅ Launch Day Plan

1. **Soft Launch**: New Zealand/Australia first
2. **Monitor**: 24 hours for critical issues  
3. **Global Release**: If no major problems
4. **Marketing**: Launch TikTok campaign

---

*Remember: Be patient, professional, and prepared to iterate. Most apps get through on the 1st or 2nd try!*