# app-preview-craft

> Free, open-source tool that turns your app screenshots into App Store and Google Play screenshot sets, app preview videos, social cards and 3D device mockups. Renders on your own machine with headless Chrome, three.js and ffmpeg — no subscription, no account, nothing uploaded.

Site: https://app-preview-agent.imshaikot.com
Source: https://github.com/imshaikot/app-preview-craft-skill
Licence: MIT (3D device models are CC-BY-4.0 and must stay attributed)

## What it is

An open-source agent skill and command-line tool that turns an app's screenshots
and screen recordings into store and marketing assets. It renders locally with
headless Chrome, three.js, sharp and ffmpeg. There is no hosted service, no
account and no subscription. Screenshots are never uploaded.

## What it produces

- App Store and Google Play screenshot sets, including the 6.9" iPhone set and
  13" iPad set that App Store Connect requires, and Play phone/tablet sizes.
- App preview videos at 886x1920, 30 fps, with the silent audio track Connect expects.
- Open Graph and social cards for X, LinkedIn, Instagram and stories, plus the
  1024x500 Google Play feature graphic.
- 2D screen videos built from screenshots or a screen recording.
- 3D device videos and mockup stills of iPhone, Galaxy and MacBook models,
  optionally on a transparent background.

## App Store themes

Each is modelled on how apps in one store category present themselves:
- stride — Health & Fitness
- ledger — Finance
- serene — Mindfulness
- canvas — Productivity
- sizzle — Food & Drink
- wander — Travel
- mixtape — Music & Audio
- arcade — Games
- snapshot — Photo & Social
- pulse — Health data

## Install

Claude Code (plugin), run as two separate commands:
  claude plugin marketplace add imshaikot/app-preview-craft-skill
  claude plugin install app-preview-craft@app-preview-craft

Other agents (Codex, Cursor, Copilot, Gemini CLI, Amp, Goose):
  git clone --depth 1 -b skill https://github.com/imshaikot/app-preview-craft-skill.git ~/.agents/skills/app-preview-craft

Requirements: Node 20+, a Chromium-based browser with WebGL, ffmpeg for video.

## Questions

Q: Do I need a subscription?
A: No. app-preview-craft is MIT-licensed and runs on your own machine. There is no account, no seat, no export cap and no watermark. Install it once and it keeps working offline.

Q: Are my unreleased screenshots uploaded anywhere?
A: No. Rendering happens locally in headless Chrome. Your screenshots never leave the machine, which matters when the app has not shipped yet and the screens are under embargo.

Q: Does it make the sizes App Store Connect actually requires?
A: Yes. It renders the 6.9" iPhone set and the 13" iPad set that Connect requires, plus the optional sizes, Google Play phone and tablet, and the 1024×500 Play feature graphic. App preview videos come out at 886×1920, 30 fps, with the silent audio track Connect expects.

Q: Can I use my own brand instead of a built-in theme?
A: Yes. Every theme property is overridable from the command line, or you can write a small JSON theme that extends a built-in one and set your own palette, fonts and device finish. A project config file can render a whole batch in one command.

Q: What are the 3D device models, and can I publish the renders?
A: They are Creative Commons BY 4.0 models from Sketchfab. You can publish the renders commercially as long as the attribution travels with them — the tool writes a CREDITS.txt next to every render that includes a device and embeds the credit in video metadata and PNG EXIF.

Q: Do I have to use an AI agent to run it?
A: No. It is a normal Node command-line tool and it ships a local preview studio you can click around in. The agent skill is a convenience: it lets you ask in plain language instead of remembering flags.