CommunityImagegithub.com

app-store-assets

Plan, make, check and ship App Store assets the way Apple asks for them — app icon, screenshots, app previews, product page header and search results art (iOS 27 creative assets), In-App Event media, custom product pages and product page tests. Holds Apple's exact specs and rejection rules and a validator for sizes, alpha, video length, frame rate and audio. Use whenever creating, reviewing, exporting or uploading any App Store image or video, or planning store listing work.

Qu'est-ce que app-store-assets ?

app-store-assets is a Claude Code agent skill that plan, make, check and ship App Store assets the way Apple asks for them — app icon, screenshots, app previews, product page header and search results art (iOS 27 creative assets), In-App Event media, custom product pages and product page tests. Holds Apple's exact specs and rejection rules and a validator for sizes, alpha, video length, frame rate and audio. Use whenever creating, reviewing, exporting or uploading any App Store image or video, or planning store listing work.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Riyad-Eita/app-store-assets/tree/HEAD

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

App Store assets

Apple's asset guidance, condensed into a checklist. The full specs are in reference/ and the validator is in scripts/. Last checked against Apple's pages on 2026-11-15. Sizes change when new devices ship, so re-read the source page when something doesn't add up.

Workflow

  1. Plan the story before making anything. Start with one idea for someone who has never heard of the app, then the three features that matter most, then the rest. Screenshots, previews and the header tell this story in the same order, in one visual style (palette, type, iconography, tone).
  2. Capture real UI. Use the current design and fictional demo data, never a real person's data (Guideline 2.3.9). Previews may contain only screen captures of the app itself (2.3.4).
  3. Compose one master per asset type, review it, then batch. Render a single screenshot or frame, check it against the rules below, and only then produce every size and language.
  4. Validate: python3 scripts/check_assets.py <folder> must report no failures.
  5. Review by eye what a script can't see: the rules below, the safe area, the poster frame, the loop point, and the video watched muted.
  6. Upload with a new version, in the Asset Library, or through the App Store Connect API. Then open App Store Connect's product page preview and check the header, the screenshots and the search result together.

What gets assets rejected

Every image and video (screenshots, previews, header, search, event media) — Review Guidelines 2.3.3–2.3.14 and Focus on your core experience:

  • No prices, discounts, "free", website URLs or © symbols.
  • No claims that can't be verified: "#1", "best", awards or press the app didn't get.
  • No Apple recognitions: Editor's Choice, App of the Day, Game of the Day, Apple Design Award.
  • No names, icons or imagery of other mobile platforms or app marketplaces (2.3.10).
  • Shows the app in use. A screenshot that is only title art, a login page or a splash screen gets rejected (2.3.3).
  • Previews contain only screen captures of the app. Captions, narration and touch indicators are allowed (2.3.4).
  • Suitable for 4+ even when the app is rated higher: no gore, weapons pointed at someone, profanity, drugs, sexual content, hate, self-harm or stereotypes (2.3.8).
  • You hold the rights to everything shown, and every account, name and number is fictional (2.3.9).
  • Paid content is marked as such where shown (2.3.2).
  • Localized for every language the listing supports, images and videos included.

What Apple rewards (and features)

Images (#image):

  • One clear focal point and strong composition, in the app's own aesthetic and the latest UI.
  • Text is a short phrase that adds to the picture rather than describes it. Overlays can show input (a touch point, typing, Pencil).
  • Key elements, text most of all, sit centered inside the safe area, because assets get cropped differently on each device.

Videos (#videos):

  • Poster frame: the still people see first. It has to work on its own.
  • Start strong: lead with the value or the best feature. Pace the cuts so people can follow, with no quick cuts and no fast motion.
  • Loop seamlessly: videos autoplay and repeat, so the last frame must flow into the first.
  • Silent first: audio is muted by default, so captions carry the message. Sound is brand texture, like a short music loop with no sudden loud parts, that loops cleanly.

Asset map

AssetWhere it showsCountKey sizeDetails
App iconEverywhere1Icon Composer .iconbelow
ScreenshotsProduct page; first 3 in search1–10 per device size and languageiPhone 1320×2868 · iPad 2064×2752 · Mac 2880×1800reference/screenshots.md
App previewsBefore the screenshots; up to 3 in search0–3 per device size and languageiPhone 886×1920 · iPad 1200×1600 · Mac 1920×1080; 15–30 sreference/app-previews.md
Product page headerTop of the product page (iOS 27+)13840×1646 (21:9)reference/creative-assets.md
Search results artSearch tab (iOS 27+)13:2, 1920×1280 – 3840×2560reference/creative-assets.md
Universal creative assetHeader, search and hero spots15244×2950 PNG (16:9)reference/creative-assets.md
In-App Event mediaEvent card / details page1 each16:9 and 9:16reference/creative-assets.md

No image may have an alpha channel. Upload the largest size and App Store Connect scales it down for smaller devices.

App icon

  • Build a layered Liquid Glass icon in Icon Composer. One design covers iPhone, iPad, Mac and Apple Watch.
  • Check the default, dark, clear and tinted appearances. It must stay recognizable at every size, from the App Store down to Spotlight.
  • Keep the icon consistent with the alternate icons and the in-app purchase icons (2.3.8).
  • Read the HIG: App icons page and watch WWDC25 Say hello to the new look of app icons.

Validator

python3 scripts/check_assets.py path/to/assets            # every image and video under the folder
python3 scripts/check_assets.py shot.png preview.mp4 --json
python3 scripts/check_assets.py assets --strict           # warnings fail too

Standard library only. Videos need ffprobe (from FFmpeg). For each file it finds every App Store slot that size can go into and checks the format, alpha channel, length, frame rate, codec, H.264 level, file size and audio. Per folder, it flags more than 10 screenshots or more than 3 previews for one slot. Exit code 1 on any failure.

Growing the listing

  • Custom product pages — up to 70 extra versions of the product page, each with its own screenshots, previews, promotional text and URL, for one audience or campaign. (guide)
  • Product page optimization — test up to three treatments (icon, screenshots, previews, header art) against the original for up to 90 days, one test at a time. Alternate icons have to ship in the binary. (guide)
  • In-App Events — a timely moment (Major Update, Premiere, Live Event…) gets its own card in search, on the product page and in editorial.

Sources

Skills associés