app-store-screenshots README

The project's README from github.com/ParthJadhav/app-store-screenshots. As one markdown file: README.md.

App Store & Google Play Screenshots Generator

A skill for AI coding agents that scaffolds a production-ready Next.js editor for App Store and Google Play marketing screenshots. It gives you a connected canvas, real device frames, inspector controls, persistent project state, and one-click export bundles at store-ready sizes.

Current connected-canvas editor showing a Bloom screenshot deck

Example screenshots generated with this skill were accepted for Bloom Coffee Shelf Recipe on the App Store.

What It Does

Current Editor UI

Tip: when capturing source iPhone screenshots, the 6.1-inch simulator is usually the easiest starting point because it reduces manual image adjustment inside the frames.

Install

Using npx skills

npx skills add ParthJadhav/app-store-screenshots

Install globally:

npx skills add ParthJadhav/app-store-screenshots -g

Install for a specific agent:

npx skills add ParthJadhav/app-store-screenshots -a claude-code

This works with Claude Code, Cursor, Windsurf, OpenCode, Codex, and other agents supported by skills.

Manual install

git clone https://github.com/ParthJadhav/app-store-screenshots ~/.claude/skills/app-store-screenshots

Usage

Once installed, ask your coding agent for store screenshots:

Build App Store and Google Play screenshots for my app.

The skill guides the agent to ask for your app context, source screenshots, platforms, locales, visual direction, and slide count before generating the editor project.

Example Prompts

Build App Store screenshots for my habit tracker.
The app helps people stay consistent with simple daily routines.
I want 6 slides, clean minimal style, warm neutrals, and a calm premium feel.

Generate App Store screenshots for my personal finance app.
The main strengths are fast expense capture, clear monthly trends, and shared budgets.
I want a sharp modern style with high contrast and 7 slides.

Build App Store screenshots for my language learning app.
I need English, German, and Arabic screenshot sets.
Use two reusable themes: clean-light and dark-bold.
Make sure Arabic slides feel RTL-native, not just translated.

Better Prompt Tips

What Gets Scaffolded

If starting from an empty folder, the skill creates a Next.js project like this:

project/
├── public/
│   ├── mockup.png
│   ├── app-icon.png
│   └── screenshots/
│       ├── apple/
│       │   ├── iphone/{locale}/01.png
│       │   └── ipad/{locale}/01.png
│       └── android/
│           ├── phone/{locale}/01.png
│           ├── tablet-7/portrait/{locale}/01.png
│           ├── tablet-10/landscape/{locale}/01.png
│           └── feature-graphic/{locale}/01.png
├── app-store-screenshots.json
├── src/app/
│   ├── layout.tsx
│   └── page.tsx
├── src/components/editor/
│   ├── screenshot-editor.tsx
│   ├── toolbar.tsx
│   ├── sidebar.tsx
│   ├── inspector.tsx
│   ├── preview-stage.tsx
│   ├── slide-canvas.tsx
│   ├── screenshot-picker.tsx
│   └── device-frames.tsx
└── src/lib/
    ├── constants.ts
    ├── defaults.ts
    ├── storage.ts
    ├── image-cache.ts
    └── types.ts

The template README inside skills/app-store-screenshots/template/README.md documents the editor internals in more detail.

Editor Workflow

  1. Capture real app screenshots from a simulator, emulator, or device.
  2. Ask your agent to scaffold or migrate the screenshot project.
  3. Run the dev server and open the editor.
  4. Use the sidebar to organize screens and the inspector to edit copy, layouts, screenshots, and elements.
  5. Choose Connected or Isolated mode depending on whether elements should cross screen boundaries.
  6. Click Export bundle to download store-ready PNGs.

Uploaded files are saved under public/screenshots/uploaded/, and the canonical deck state is saved in app-store-screenshots.json. Commit both to make the deck reproducible after a fresh clone.

Export Sizes

Apple App Store

Display Resolution
6.9" 1320 x 2868
6.5" 1284 x 2778
6.3" 1206 x 2622
6.1" 1125 x 2436

Google Play Store

Device Resolution
Phone portrait 1080 x 1920
7" tablet portrait 1200 x 1920
7" tablet landscape 1920 x 1200
10" tablet portrait 1600 x 2560
10" tablet landscape 2560 x 1600
Feature graphic 1024 x 500

Screenshots are designed at the largest size for each platform and scaled down for smaller exports. Android frames are CSS-rendered, while iPhone uses the included mockup.png bezel.

Project State

Design Standards

Tech Stack

Dependency Purpose
Next.js Dev server and app shell
React Editor UI
TypeScript Project and slide state safety
Tailwind CSS Styling
shadcn/ui + Radix Controls, dialogs, selects, tooltips
html-to-image Exact PNG rendering
JSZip Bundle downloads
dnd-kit Screen reordering
react-rnd Draggable and resizable canvas elements

Requirements

Contributing

Contributions are welcome, especially around export reliability, screenshot design guidance, migrations, and cross-agent compatibility. Start with CONTRIBUTING.md.

License

MIT

Author

Created by Parth Jadhav.

app-store-screenshots (ParthJadhav/app-store-screenshots)

Searching Database…

7.4K ·GitHub
App-store-screenshots
What is this?A skill for AI coding agents (like Claude Code, Cursor, Windsurf, OpenCode, and Codex) that scaffolds a full Next.js editor for creating App Store and Google Play marketing screenshots, complete with device frames, a connected canvas, and one-click export bundles at store-ready sizes.
Is this a ready-made app, or something my coding agent builds for me?It is an agent skill, not a standalone app: installing it teaches your coding agent to scaffold a complete Next.js project with the screenshot editor directly in your repo, which you then run and customize yourself.
How do I install and use it?Install it globally or for a specific agent with the 'npx skills' command, then just ask your coding agent for store screenshots and it scaffolds the Next.js editor project for you to run locally.
What do I need on my machine first?Node.js 18 or newer, plus one package manager of your choice — bun, pnpm, yarn, or npm — to run the scaffolded editor project.
Does it support both iOS and Android, or just one platform?Both: it generates decks for iOS, iPad, Android phone, Android tablet, and Play Store feature graphics, and exports the exact PNG sizes required by each store.
What happens to my project data between sessions?Everything — app name, platforms, devices, locales, theme, slides, screenshot paths, and transforms — is saved to app-store-screenshots.json, making the deck git-trackable and resumable, with localStorage used for fast reloads.
What's the difference between Connected and Isolated canvas mode?Connected canvas lets phones, captions, and decorative elements span adjacent screenshots across the whole strip before exporting precise crops, while Isolated mode protects older decks so offscreen elements never leak into neighboring exports.
Can I customize the visual theme of the screenshots?Yes, custom themes are defined in src/lib/constants.ts, and any unrecognized theme id just falls back to the default clean-light theme.
Has anyone actually shipped screenshots made with this skill to the App Store?Yes — the README notes that example screenshots generated with this skill were accepted for the Bloom Coffee Shelf Recipe app on the App Store.
What are similar projects?ai-website-cloner-template, evondevKit, ui-ux-pro-max-skill, design-extract, ChunUI, appllama-skills, SwiftUI-Agent-Skill, stitch-skills
Which topics is it in?automate, appstore, skills-sh, shadcn-ui, ios-app, screenshot, marketing, swiftui, agent-skill, tailwindcss, apple, design
Creator
ParthJadhav
Size
30.9 MB
Stars
7.4K
Updated
CommitOct 16
Age
7mo
Commits · 90 Days