# App Store Assets Specification

This document outlines the required visual assets for iOS App Store and Google
Play Store listings.

---

## Table of Contents

1. [App Icons](#app-icons)
2. [Screenshots](#screenshots)
3. [App Preview Videos](#app-preview-videos)
4. [Feature Graphics](#feature-graphics)
5. [Promotional Images](#promotional-images)
6. [Brand Guidelines](#brand-guidelines)

---

## App Icons

### iOS App Store

| Size (px)   | Scale | Usage                        |
| ----------- | ----- | ---------------------------- |
| 1024 × 1024 | 1x    | App Store listing            |
| 180 × 180   | 3x    | iPhone (60pt @ 3x)           |
| 120 × 120   | 2x    | iPhone (60pt @ 2x)           |
| 167 × 167   | 2x    | iPad Pro (83.5pt @ 2x)       |
| 152 × 152   | 2x    | iPad (76pt @ 2x)             |
| 76 × 76     | 1x    | iPad (76pt @ 1x)             |
| 120 × 120   | 2x    | Spotlight (40pt @ 3x iPhone) |
| 80 × 80     | 2x    | Spotlight (40pt @ 2x)        |
| 87 × 87     | 3x    | Settings (29pt @ 3x)         |
| 58 × 58     | 2x    | Settings (29pt @ 2x)         |

**Requirements:**

- PNG format, no transparency
- No rounded corners (iOS adds them automatically)
- No alpha channel
- sRGB or P3 color space

### Google Play Store

| Size (px) | Usage                       |
| --------- | --------------------------- |
| 512 × 512 | Play Store listing (hi-res) |

**Requirements:**

- PNG or JPEG format
- 32-bit PNG (with alpha) allowed
- No rounded corners (Play Store adds them)
- Max file size: 1024 KB

### Icon Design Guidelines

**Design Elements:**

- Primary element: Stylized lotus flower or peaceful figure
- Color palette: Calming blues, teals, and soft gradients
- Style: Minimal, modern, recognizable at small sizes

**Do:**

- Keep the design simple and iconic
- Ensure visibility at 29pt (smallest size)
- Use the brand color palette consistently
- Test on both light and dark backgrounds

**Don't:**

- Include text (except single letters/characters)
- Use photographs
- Include UI elements
- Use transparency for iOS icons

---

## Screenshots

### iOS App Store

#### iPhone Screenshots

| Device            | Size (px)   | Orientation |
| ----------------- | ----------- | ----------- |
| iPhone 15 Pro Max | 1290 × 2796 | Portrait    |
| iPhone 15 Pro     | 1179 × 2556 | Portrait    |
| iPhone 15 Plus    | 1290 × 2796 | Portrait    |
| iPhone 15         | 1179 × 2556 | Portrait    |
| iPhone 14 Plus    | 1284 × 2778 | Portrait    |
| iPhone 8 Plus     | 1242 × 2208 | Portrait    |

**Required:** At least iPhone 6.7" and 6.5" display sizes

#### iPad Screenshots

| Device         | Size (px)   | Orientation |
| -------------- | ----------- | ----------- |
| iPad Pro 12.9" | 2048 × 2732 | Portrait    |
| iPad Pro 12.9" | 2732 × 2048 | Landscape   |
| iPad Pro 11"   | 1668 × 2388 | Portrait    |

**Required:** At least 12.9" iPad Pro screenshots

#### Apple Watch Screenshots

| Device               | Size (px) |
| -------------------- | --------- |
| Apple Watch Ultra    | 410 × 502 |
| Apple Watch Series 9 | 396 × 484 |
| Apple Watch SE       | 368 × 448 |

### Google Play Store

| Device Type | Size (px)                 | Requirement |
| ----------- | ------------------------- | ----------- |
| Phone       | 1080 × 1920 (minimum)     | Required    |
| Phone       | 1440 × 2560 (recommended) | Recommended |
| 7" Tablet   | 1200 × 1920               | Optional    |
| 10" Tablet  | 1800 × 2560               | Optional    |

**Requirements:**

- Minimum 2 screenshots, maximum 8
- JPEG or 24-bit PNG (no alpha)
- Minimum dimension: 320px
- Maximum dimension: 3840px
- Aspect ratio: 16:9 or 9:16

### Screenshot Content Strategy

**Screenshot Order (Recommended):**

1. **Hero Shot** - App home screen with key value proposition
2. **Core Feature** - Meditation player showing session in progress
3. **Sleep Content** - Sleep stories and sounds
4. **Progress/Stats** - Practice rhythm and achievements
5. **Courses** - Learning path or course selection
6. **Timer** - Customizable meditation timer
7. **Background Sounds** - Ambient sound mixer
8. **Offline** - Download/offline capability

### Screenshot Design Template

```
┌─────────────────────────────────┐
│                                 │
│   [HEADLINE - 2-4 words]        │  ← Bold, large text
│                                 │
│   [Subtext - 1 line]            │  ← Smaller supporting text
│                                 │
│  ┌─────────────────────────┐    │
│  │                         │    │
│  │                         │    │
│  │    [Device Frame]       │    │
│  │    [App Screenshot]     │    │
│  │                         │    │
│  │                         │    │
│  │                         │    │
│  └─────────────────────────┘    │
│                                 │
│   [Optional: Feature icons]     │
│                                 │
└─────────────────────────────────┘
```

**Design Guidelines:**

- Use device frames for professional appearance
- Consistent background color/gradient across all screenshots
- Headlines in brand font, max 4 words
- Subtext should clarify the headline
- Actual app content should be visible and readable

---

## App Preview Videos

### iOS App Store

| Device         | Resolution  | Duration  |
| -------------- | ----------- | --------- |
| iPhone 6.7"    | 886 × 1920  | 15-30 sec |
| iPhone 6.5"    | 886 × 1920  | 15-30 sec |
| iPhone 5.5"    | 1080 × 1920 | 15-30 sec |
| iPad Pro 12.9" | 1200 × 1600 | 15-30 sec |

**Requirements:**

- Format: H.264, M4V, MP4, or MOV
- Frame rate: 30 fps
- Audio: AAC, 256 kbps minimum
- Duration: 15-30 seconds
- Max file size: 500 MB

### Google Play Store

| Type         | Resolution  | Duration   |
| ------------ | ----------- | ---------- |
| Promo Video  | 1920 × 1080 | 30-120 sec |
| YouTube Link | N/A         | Any        |

**Requirements:**

- YouTube video link
- Public or unlisted visibility
- Landscape orientation recommended
- No age restrictions

### Video Content Guidelines

**Structure (30-second video):**

| Time      | Content                           |
| --------- | --------------------------------- |
| 0:00-0:03 | Hook - Emotional problem/desire   |
| 0:03-0:08 | Solution - Introduce Tara         |
| 0:08-0:20 | Features - Show key functionality |
| 0:20-0:27 | Social proof - User testimonials  |
| 0:27-0:30 | CTA - Download/trial message      |

**Do:**

- Start with the most compelling content
- Show actual app footage
- Include captions (many watch without sound)
- End with clear call-to-action

**Don't:**

- Include pricing information
- Show competitor apps
- Use copyrighted music without license
- Include content that may become outdated

---

## Feature Graphics

### Google Play Feature Graphic

**Size:** 1024 × 500 pixels

**Requirements:**

- JPEG or 24-bit PNG (no alpha)
- Landscape orientation only
- Text should be minimal and large

**Design Template:**

```
┌─────────────────────────────────────────────────────┐
│                                                     │
│    [LOGO]   [TAGLINE: 3-5 words]                   │
│                                                     │
│         [Background: Peaceful imagery]              │
│         [Optional: Device mockup]                   │
│                                                     │
└─────────────────────────────────────────────────────┘
```

**Variants to Create:**

1. **Default** - Logo + tagline on gradient background
2. **Seasonal** - Holiday/seasonal themed
3. **Feature Launch** - New feature highlight
4. **Sale/Promo** - Trial emphasis

### Promotional Tiles (Google Play)

| Type  | Size (px)  | Usage              |
| ----- | ---------- | ------------------ |
| Small | 180 × 120  | Browse pages       |
| Large | 1024 × 500 | Featured placement |

---

## Promotional Images

### Apple App Store Promotional Art

For featuring consideration, prepare these assets:

| Asset Type    | Size (px)   | Notes             |
| ------------- | ----------- | ----------------- |
| Hero Image    | 2880 × 1440 | Horizontal banner |
| Square Tile   | 1024 × 1024 | Today tab         |
| Stacked Image | 1024 × 1024 | App collections   |

### Google Play Promotional Assets

| Asset Type         | Size (px)   | Notes           |
| ------------------ | ----------- | --------------- |
| TV Banner          | 1280 × 720  | Android TV      |
| Daydream 360 VR    | 4096 × 4096 | VR content      |
| Wear OS Screenshot | 384 × 384   | Wear OS listing |

### Social Media Assets

| Platform  | Size (px)   | Usage         |
| --------- | ----------- | ------------- |
| Instagram | 1080 × 1080 | Feed posts    |
| Instagram | 1080 × 1920 | Stories       |
| Facebook  | 1200 × 630  | Link previews |
| Twitter   | 1200 × 675  | Card images   |
| LinkedIn  | 1200 × 627  | Share images  |

---

## Brand Guidelines

### Color Palette

| Color Name    | Hex     | RGB           | Usage               |
| ------------- | ------- | ------------- | ------------------- |
| Primary Blue  | #4A90D9 | 74, 144, 217  | Primary brand color |
| Deep Teal     | #1A5F7A | 26, 95, 122   | Headers, CTAs       |
| Soft Lavender | #E8E4F0 | 232, 228, 240 | Backgrounds         |
| Warm Cream    | #F5F2EB | 245, 242, 235 | Light backgrounds   |
| Charcoal      | #2D3436 | 45, 52, 54    | Text                |
| Soft Gray     | #B8C5D0 | 184, 197, 208 | Secondary text      |

### Typography

**Primary Font:** Inter (or system font fallback)

| Style     | Weight   | Size | Usage           |
| --------- | -------- | ---- | --------------- |
| Heading 1 | Bold     | 32px | Main headlines  |
| Heading 2 | SemiBold | 24px | Section headers |
| Heading 3 | Medium   | 18px | Card titles     |
| Body      | Regular  | 16px | Body text       |
| Caption   | Regular  | 14px | Supporting text |

### Logo Usage

**Clear Space:** Minimum clear space around logo = height of the "T" in Tara

**Minimum Size:**

- Digital: 80px width
- Print: 0.75 inches width

**Backgrounds:**

- Primary: Use on light backgrounds (#F5F2EB or lighter)
- Reversed: Use white logo on dark backgrounds (#1A5F7A or darker)

**Don't:**

- Stretch or distort the logo
- Change logo colors outside brand palette
- Add effects (shadows, gradients, outlines)
- Place on busy backgrounds
- Rotate the logo

### Photography Style

**Mood:**

- Calm, peaceful, serene
- Natural lighting preferred
- Soft, muted color grading
- Minimal, uncluttered compositions

**Subjects:**

- Diverse representation
- People meditating in natural settings
- Abstract nature imagery (water, sky, plants)
- Avoid clichéd "meditation poses"

**Technical:**

- High resolution (minimum 300 DPI for print)
- sRGB color space for digital
- Model releases required for identifiable people

---

## Asset Checklist

### Launch Requirements

**iOS App Store:**

- [ ] App icon (1024 × 1024)
- [ ] iPhone 6.7" screenshots (minimum 3)
- [ ] iPhone 6.5" screenshots (minimum 3)
- [ ] iPad Pro 12.9" screenshots (minimum 3)
- [ ] App Preview video (optional but recommended)

**Google Play Store:**

- [ ] App icon (512 × 512)
- [ ] Feature graphic (1024 × 500)
- [ ] Phone screenshots (minimum 2, recommend 8)
- [ ] Promo video (YouTube link, optional)

**Recommended Additional:**

- [ ] Apple Watch screenshots
- [ ] Tablet screenshots (both platforms)
- [ ] Localized screenshots for key markets
- [ ] Seasonal variant graphics
- [ ] Press kit assets

### Update Checklist

When updating store listings:

- [ ] Update screenshots if UI has changed
- [ ] Refresh What's New text
- [ ] Update promotional text if relevant
- [ ] Check all links are working
- [ ] Verify pricing is correct
- [ ] Update feature graphic if promoting new feature

---

## File Naming Convention

```
tara_[asset-type]_[platform]_[device]_[size]_[variant].[ext]

Examples:
tara_icon_ios_1024x1024.png
tara_screenshot_ios_iphone15pro_1179x2556_01-home.png
tara_screenshot_android_phone_1440x2560_02-meditation.png
tara_feature_android_1024x500_default.png
tara_preview_ios_iphone67_30sec.mp4
```

---

## Asset Delivery

### Storage Location

All final assets should be stored in:

```
/assets/marketing/
├── ios/
│   ├── icons/
│   ├── screenshots/
│   ├── previews/
│   └── promotional/
├── android/
│   ├── icons/
│   ├── screenshots/
│   ├── feature-graphics/
│   └── promotional/
├── social/
│   ├── instagram/
│   ├── facebook/
│   └── twitter/
└── press-kit/
    ├── logos/
    ├── screenshots/
    └── media/
```

### Handoff Format

For design handoff, provide:

- Original source files (Figma, Sketch, or PSD)
- Exported assets in required formats
- Asset specification document
- Brand guidelines PDF

---

_Last Updated: January 2026_

_For design inquiries, contact design@tara.app_
