# Android Play Store Assets

This directory contains metadata and assets for the Google Play Store listing.

## Directory Structure

```
store/android/
├── metadata.json         # Play Store metadata
├── graphics/             # Store graphics (required)
│   ├── icon.png         # App icon (512x512)
│   ├── feature-graphic.png  # Feature graphic (1024x500)
│   └── promo-graphic.png    # Promo graphic (180x120)
├── screenshots/          # App screenshots (required)
│   ├── phone/           # Phone screenshots (2-8)
│   ├── tablet_7/        # 7" tablet screenshots
│   └── tablet_10/       # 10" tablet screenshots
└── README.md            # This file
```

## Graphics Requirements

### App Icon

- **Size**: 512 x 512 pixels
- **Format**: 32-bit PNG (with alpha)
- **Notes**: Should match adaptive icon foreground

### Feature Graphic (Required)

- **Size**: 1024 x 500 pixels
- **Format**: PNG or JPEG
- **Notes**: Main promotional graphic shown in Play Store

### Promo Graphic (Optional)

- **Size**: 180 x 120 pixels
- **Format**: PNG or JPEG
- **Notes**: Used in some promotional placements

## Screenshot Requirements

### Phone Screenshots (Required)

- **Minimum**: 2 screenshots
- **Maximum**: 8 screenshots
- **Dimensions**:
  - Min: 320px on any side
  - Max: 3840px on any side
  - Aspect ratio: 16:9 or 9:16
- **Recommended**: 1080 x 1920 pixels (portrait)

### 7" Tablet Screenshots (Optional)

- **Minimum**: 0 screenshots
- **Maximum**: 8 screenshots
- **Recommended**: 1200 x 1920 pixels

### 10" Tablet Screenshots (Optional)

- **Minimum**: 0 screenshots
- **Maximum**: 8 screenshots
- **Recommended**: 1920 x 1200 pixels (landscape) or 1200 x 1920 (portrait)

## Recommended Screenshots

1. **Home Screen** - Show daily meditation and streak
2. **Browse/Meditate Screen** - Display categories
3. **Player Screen** - Show active meditation playback
4. **Timer Screen** - Display meditation timer
5. **Progress Screen** - Show statistics and achievements
6. **Profile/Settings** - Show personalization options

## Video Assets

### Promo Video (Optional)

- **URL**: YouTube video URL
- **Duration**: 30 seconds - 2 minutes
- **Content**: Feature highlights and app walkthrough

## In-App Products

### Subscriptions

| Product ID           | Name                 | Price (USD) | Billing |
| -------------------- | -------------------- | ----------- | ------- |
| tara_premium_monthly | Tara Premium Monthly | $12.99      | Monthly |
| tara_premium_annual  | Tara Premium Annual  | $79.99      | Yearly  |

### One-Time Purchases

| Product ID            | Name                  | Price (USD) |
| --------------------- | --------------------- | ----------- |
| tara_premium_lifetime | Tara Premium Lifetime | $199.99     |

## Content Rating

The app should be rated for **Everyone** with:

- No violence
- No sexual content
- No profanity
- No gambling
- No substance references

## Data Safety Section

Required declarations for Play Console:

- Email collection for account management
- Name collection (optional) for personalization
- Meditation/health data for app functionality
- Device IDs for analytics

## Pre-Launch Checklist

### Required

- [ ] App icon (512x512 PNG)
- [ ] Feature graphic (1024x500)
- [ ] At least 2 phone screenshots
- [ ] Full description (4000 char max)
- [ ] Short description (80 char max)
- [ ] Privacy policy URL
- [ ] App category selected
- [ ] Content rating questionnaire completed
- [ ] Data safety form completed

### Recommended

- [ ] Promo video (YouTube)
- [ ] Tablet screenshots
- [ ] All localizations completed
- [ ] Release notes prepared
- [ ] Internal testing completed

## Testing Tracks

### Internal Testing

- Up to 100 testers
- Instant distribution
- For QA team

### Closed Testing

- Custom tester groups
- Multiple tracks available
- For beta users

### Open Testing

- Public beta
- Anyone can join
- For community feedback

### Production

- Full public release
- Reviewed by Google
- Appears in Play Store

## Google Play Billing

### Setup Steps

1. Create license key in Play Console
2. Configure products in Play Console
3. Add google-services.json to project
4. Configure RevenueCat with Play Store credentials
5. Test with license test accounts

### Testing Purchases

- Use Play Console license testers
- Test cards always approve
- No real charges during testing

## App Bundle

### Build Command

```bash
eas build --platform android --profile production
```

### Output

- AAB (Android App Bundle) for Play Store
- Signed with upload key
- Optimized for device delivery

## Version Management

### Version Code

- Integer, must increase with each release
- Used by Play Store for updates
- Managed by EAS in eas.json

### Version Name

- Human-readable version (e.g., "1.0.0")
- Shown to users in Play Store
- Follows semantic versioning

## Release Notes Template

```
Version X.Y.Z

What's New:
• [Feature 1]
• [Feature 2]
• [Bug fix]

We'd love to hear your feedback! support@tara.app
```

## Contact

- Developer Email: support@tara.app
- Privacy Policy: https://tara.app/privacy
- Terms of Service: https://tara.app/terms
