Skip to content

Commit 464202e

Browse files
jjoonleojjoonleo
authored
Merge pull request #493 from DevKor-github/codexd/448-play-listing-graphics
[codex] Add Play listing graphics checklist
2 parents cd49f7e + 230195f commit 464202e

3 files changed

Lines changed: 163 additions & 0 deletions

File tree

‎docs/Google-Play-Listing-Graphics.md‎

Lines changed: 105 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,105 @@
1+
# Google Play Listing Graphics
2+
3+
Checklist status: prepared for design/product completion before Play Console
4+
upload.
5+
6+
This document covers release issue #448. It does not create final artwork. Use
7+
it to brief the designer or release owner, validate exported assets, and confirm
8+
that launcher and Play listing graphics stay consistent.
9+
10+
References checked on 2026-05-10:
11+
12+
- [Add preview assets to showcase your app - Play Console Help](https://support.google.com/googleplay/android-developer/answer/9866151?hl=en)
13+
- [Metadata - Play Console Help](https://support.google.com/googleplay/android-developer/answer/9898842?hl=en)
14+
- [Manage your store listing, experiment, and event graphics with the Asset Library - Play Console Help](https://support.google.com/googleplay/android-developer/answer/16386748?hl=en)
15+
16+
## Current Repo Source
17+
18+
- Public app name: `OnTime`.
19+
- Android application ID: `club.devkor.ontime`.
20+
- Launcher source image: `assets/icons/app_icon.png`.
21+
- Launcher generation config: `flutter_launcher_icons.yaml`.
22+
- Android adaptive icon background: `#5C79FB`.
23+
- Generated Android launcher outputs:
24+
- `android/app/src/main/res/mipmap-mdpi/ic_launcher.png` - 48 x 48, alpha.
25+
- `android/app/src/main/res/mipmap-hdpi/ic_launcher.png` - 72 x 72, alpha.
26+
- `android/app/src/main/res/mipmap-xhdpi/ic_launcher.png` - 96 x 96, alpha.
27+
- `android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png` - 144 x 144, alpha.
28+
- `android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png` - 192 x 192, alpha.
29+
30+
## Required Asset Package
31+
32+
Prepare these assets from the approved design source before opening the Play
33+
Console main store listing.
34+
35+
| Asset | Required export | Current owner |
36+
| --- | --- | --- |
37+
| App icon | 512 x 512, 32-bit PNG with alpha, maximum 1024 KB | Design/release owner |
38+
| Feature graphic | 1024 x 500, JPEG or 24-bit PNG with no alpha | Design/release owner |
39+
| Phone screenshots | Owned by #449; minimum two screenshots, JPEG or 24-bit PNG with no alpha, each side 320-3840 px and long side no more than twice the short side | #449 owner |
40+
41+
For better Play recommendation eligibility, prepare at least four app
42+
screenshots at 9:16 portrait 1080 x 1920 or 16:9 landscape 1920 x 1080. Final
43+
screenshots must come from real release screens under #449.
44+
45+
## Visual Consistency Checklist
46+
47+
- Use the approved `OnTime` launcher mark for the Play app icon.
48+
- Confirm the Play app icon and the installed Android launcher icon are the
49+
same brand mark, colors, and shape treatment. The Play icon can be higher
50+
fidelity, but it must not look like a different product.
51+
- If `assets/icons/app_icon.png` changes, regenerate launcher icons before
52+
release:
53+
54+
```sh
55+
flutter pub get
56+
dart run flutter_launcher_icons
57+
```
58+
59+
- Re-check generated Android icons in `android/app/src/main/res/mipmap-*` and
60+
`android/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml`.
61+
- Keep the feature graphic visually related to the app icon and in-app style,
62+
but do not make it a large duplicate of the icon.
63+
- Avoid fine details, tiny text, or edge-critical content in the feature
64+
graphic because Play surfaces may crop or scale it.
65+
- Keep key feature graphic content near the center and background-only elements
66+
near the edges.
67+
- Do not include store badges, ranking claims, promotional pricing, calls to
68+
action, unsupported features, or third-party marks without permission.
69+
- Match claims to shipped functionality listed in
70+
`docs/Google-Play-Listing-Copy.md`.
71+
- Provide Play Console alt text for the feature graphic and screenshots using
72+
concise descriptions of the actual content.
73+
74+
## Human Completion Steps
75+
76+
1. Get design/product approval for the final launcher mark and feature graphic.
77+
2. Export the Play app icon and feature graphic in the required formats.
78+
3. Capture final screenshots through #449.
79+
4. Compare the uploaded Play app icon against an installed release build icon.
80+
5. Confirm graphics do not imply unsupported features, social/UGC behavior,
81+
awards, rankings, discounts, or platform affiliations.
82+
6. Upload approved assets in Play Console under
83+
`Grow users > Store presence > Main store listing`.
84+
7. Store the final source design files and upload-ready exports in the team's
85+
agreed design or release asset location, and record that location in the
86+
release checklist or issue comment.
87+
88+
## Completion Evidence Template
89+
90+
Paste this into #448 after the human work is done:
91+
92+
```md
93+
## Play listing graphics completion evidence
94+
95+
- Design source location:
96+
- Upload-ready asset location:
97+
- Play app icon: 512 x 512 PNG with alpha, <= 1024 KB: yes/no
98+
- Feature graphic: 1024 x 500 JPEG or 24-bit PNG without alpha: yes/no
99+
- Launcher icon consistency checked against installed release build: yes/no
100+
- Screenshots supplied by #449: yes/no
101+
- Unsupported feature / ranking / promotional claim review: pass/fail
102+
- Play Console upload completed by:
103+
- Date:
104+
- Notes:
105+
```

‎docs/Release-Checklist.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -150,6 +150,9 @@ flutter build appbundle --release
150150
target stores.
151151
- Use `docs/Google-Play-Listing-Copy.md` as the draft source for Google Play
152152
short and full descriptions until product/design approve final copy.
153+
- Use `docs/Google-Play-Listing-Graphics.md` as the checklist for Play app
154+
icon, feature graphic, screenshot asset requirements, and launcher-icon
155+
consistency evidence.
153156
- Use `docs/Google-Play-Data-Safety.md` as the source-backed worksheet for
154157
Play Data safety answers after privacy, backend deletion, account deletion
155158
URL, and final SDK/provider prerequisites are resolved.

‎plans/448-play-listing-graphics-plan.md‎

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
# Issue 448 Play Listing Graphics Plan
2+
3+
## Goal
4+
5+
Prepare the repo-side checklist and verification path for Play listing graphics
6+
under release issue #448 and parent track #466.
7+
8+
## Context
9+
10+
- Parent issue #466 orders this after #446 app identity and #447 Play listing
11+
copy.
12+
- Issue #448 is labeled `manual`.
13+
- #446 is closed and confirms the public app name is `OnTime` and Android
14+
application ID is `club.devkor.ontime`.
15+
- #447 is closed and adds `docs/Google-Play-Listing-Copy.md` as the listing
16+
copy source.
17+
- Current launcher source is `assets/icons/app_icon.png`, and
18+
`flutter_launcher_icons.yaml` generates Android launcher icons from that
19+
source with adaptive background `#5C79FB`.
20+
21+
## Decisions
22+
23+
- Treat final graphic production and Play Console upload as external manual
24+
work because the issue requires final design/product assets or design-owner
25+
input.
26+
- Do not fabricate feature graphics, screenshots, or Play Console assets.
27+
- Provide a checklist that names the current Google Play size and format
28+
requirements checked on 2026-05-10, the repo launcher-icon source of truth,
29+
and the consistency checks a human must run before submission.
30+
- Keep release screenshots out of scope except to point to #449, because that
31+
sub-issue owns capturing real release screenshots.
32+
33+
## Steps
34+
35+
1. Inspect #466 and #448 metadata, labels, prerequisites, and comments.
36+
2. Confirm the active branch is `codexd/448-play-listing-graphics`.
37+
3. Review current launcher icon configuration and generated Android icon files.
38+
4. Confirm current Play listing graphic requirements from official Google Play
39+
documentation.
40+
5. Add a scoped Play listing graphics checklist under `docs/`.
41+
6. Link the checklist from `docs/Release-Checklist.md`.
42+
7. Verify the documentation diff and commit only #448-related files.
43+
44+
## Validation
45+
46+
- `git diff --check`
47+
- `sips -g pixelWidth -g pixelHeight -g hasAlpha assets/icons/app_icon.png web/icons/Icon-512.png web/icons/Icon-192.png android/app/src/main/res/mipmap-mdpi/ic_launcher.png android/app/src/main/res/mipmap-hdpi/ic_launcher.png android/app/src/main/res/mipmap-xhdpi/ic_launcher.png android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png`
48+
- Manual review of `docs/Google-Play-Listing-Graphics.md` against #448
49+
acceptance criteria.
50+
51+
## Blockers
52+
53+
- Final feature graphic and listing art require design-owner approval.
54+
- Play Console upload and visual comparison require human Play Console access.
55+
- Screenshot capture remains covered by #449.

0 commit comments

Comments
 (0)