# Google Play listing assets

```
Status: Current
Owner: _null
Last reviewed: 2026-08-20
Governs: docs/design/brand/play-store/**
Review trigger: Any Google Play preview asset requirement changing; any change
                to the source screenshots, brand lockup or declared form factors
```

These are the upload-ready Google Play preview assets for issue #32. The source
of truth for requirements is
[Google's Play Console Help](https://support.google.com/googleplay/android-developer/answer/9866151?hl=en),
checked on 2026-08-20:

- Feature graphic: `1024 x 500`, JPEG or 24-bit PNG, no alpha.
- App icon: `512 x 512`, 32-bit PNG with alpha, max 1024 KB.
- Screenshots: at least two, up to eight per device type, JPEG or 24-bit PNG,
  no alpha, each side `320..3840` px, and the long side no more than twice the
  short side.
- Apps are more eligible for recommendation surfaces with at least four phone
  screenshots at `1080 x 1920` or larger in `9:16`.

This app declares no Wear OS, TV, Automotive or XR surface in its manifest, so
the committed upload set is the phone listing set plus the required feature
graphic and icon. Tablet and Chromebook screenshots can be added here if the
Play Console asks for them at submission.

## Files

| File | Purpose | Dimensions | Format |
| --- | --- | --- | --- |
| `feature-graphic.png` | Required feature graphic | `1024 x 500` | 24-bit PNG |
| `icon-512.png` | Play listing icon | `512 x 512` | 32-bit PNG |
| `phone-screenshots/*.png` | Phone screenshots | `1080 x 1920` | 24-bit PNG |

## Upload alt text

| Asset | Alt text |
| --- | --- |
| Feature graphic | Privacy: Period Tracker lockup with calendar, shield and cycle ring |
| `05-privacy-promise.png` | Privacy promise explaining that cycle data is not sold |
| `06-reminder-privacy.png` | Reminder privacy choices with discreet, maximum privacy and direct modes |
| `08-today-forecast.png` | Today screen showing a period window and confidence label |
| `09-calendar.png` | Calendar showing logged, predicted, fertile and ovulation markers |
| `10-insights.png` | Insights screen showing learned cycle averages from seeded history |
| `11-settings-privacy.png` | Settings screen with notification, privacy and data controls |
| `01-onboarding-welcome.png` | Welcome screen with cycle rings and the app's opening promise |

The screenshots are top crops from the seeded demo captures in
[`../../screenshots/`](../../screenshots/). The source captures remain there
because their README records the demo history, the status-bar setup and the
privacy checks. Cropping from the top keeps the real app UI, removes only the
extra tall-device tail, and brings the assets under Play's aspect-ratio rule.

## Regenerate

From the repository root:

```bash
convert docs/data/img/banner.webp -resize 1024x500^ -gravity center \
  -extent 1024x500 -strip PNG24:docs/design/brand/play-store/feature-graphic.png

convert docs/data/img/icon.webp -resize 512x512 -alpha set -strip \
  -define png:color-type=6 docs/design/brand/play-store/icon-512.png

for f in \
  docs/design/screenshots/05-privacy-promise.webp \
  docs/design/screenshots/06-reminder-privacy.webp \
  docs/design/screenshots/08-today-forecast.webp \
  docs/design/screenshots/09-calendar.webp \
  docs/design/screenshots/10-insights.webp \
  docs/design/screenshots/11-settings-privacy.webp \
  docs/design/screenshots/01-onboarding-welcome.webp
do
  b=$(basename "$f" .webp)
  convert "$f" -crop 1080x1920+0+0 +repage -strip \
    PNG24:"docs/design/brand/play-store/phone-screenshots/$b.png"
done
```

Run this check before upload or commit:

```bash
identify -format '%f %wx%h %[channels] %b\n' \
  docs/design/brand/play-store/feature-graphic.png \
  docs/design/brand/play-store/icon-512.png \
  docs/design/brand/play-store/phone-screenshots/*.png
```

## Review rules

- The screenshots must stay seeded demo data, never real period history.
- The status bar must show only demo furniture: time, wifi and battery, with no
  notification visible.
- No asset may state or imply a medical, diagnostic or contraceptive claim.
- PRODUCT_PLAN.md §42's forbidden imagery list applies here too: no blood drops,
  tampons, pads, uterus imagery, gender symbols or anatomical reproductive
  graphics.
