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…

这是什么?这是一个面向 AI 编码代理(如 Claude Code、Cursor、Windsurf、OpenCode 和 Codex)的技能,可搭建一个完整的 Next.js 编辑器,用于制作 App Store 和 Google Play 的宣传截图,包含设备边框、联动画布,以及一键导出符合商店尺寸要求的整套图片。
这是一个现成的应用,还是需要我的编码代理替我搭建的东西?它是一个代理技能,而不是独立应用:安装后,你的编码代理会学会直接在你的仓库中搭建一个包含截图编辑器的完整 Next.js 项目,之后由你自行运行和定制。
怎么安装和使用它?用 npx skills 命令将其全局安装或安装到特定代理,然后直接向你的编码代理索要商店截图,它就会为你搭建 Next.js 编辑器项目,供你在本地运行。
我的电脑上需要先装什么?需要 Node.js 18 或更新版本,再加上你选定的任意一种包管理器——bun、pnpm、yarn 或 npm——用于运行搭建好的编辑器项目。
它同时支持 iOS 和 Android,还是只支持其中一个平台?两者都支持:它可以生成适用于 iOS、iPad、Android 手机、Android 平板以及 Play Store 精选图的设计稿,并导出各商店要求的确切 PNG 尺寸。
我的项目数据在不同会话之间会怎样保存?所有内容——应用名称、平台、设备、语言区域、主题、幻灯片、截图路径和变换参数——都会保存到 app-store-screenshots.json,使整套设计稿可被 git 跟踪、可从中断处继续,同时利用 localStorage 实现快速重新加载。
Connected 和 Isolated 画布模式有什么区别?Connected 画布允许手机、文字说明和装饰元素跨越相邻截图、贯穿整条长图,之后再导出精确的裁切区域;而 Isolated 模式则保护旧版设计稿,确保画布外的元素不会泄漏到相邻的导出结果中。
我能自定义截图的视觉主题吗?可以,自定义主题在 src/lib/constants.ts 中定义,任何无法识别的主题 id 都会回退到默认的 clean-light 主题。
真的有人把这个技能制作的截图上架到 App Store 了吗?有——README 提到,用这个技能生成的示例截图已被 App Store 上的 Bloom Coffee Shelf Recipe 应用采用。
Size
30.9 MB
Stars
7.4K
Updated
CommitOct 16
Age
7mo
Commits · 90 Days