BFG SolutionsBFG Solutions

Products/Shotcraft

Shotcraft

Open source

Capture your live app. Ship every screenshot you need.

Most screenshot tools make you take screenshots first, then upload them. Shotcraft does both halves: it drives your running web app via Playwright, captures every screen at every viewport you need, and composites the raws through device-frame templates into shippable images for the App Store, Play Store, your README, and social cards.

Drop it into your repo as a CLI, or open the hosted web interface to browse templates and build configs without installing anything.

Shotcraft — capture your live app, ship every screenshot you need.

The hero above was rendered by Shotcraft itself, against the Shotcraft docs site. Eat-our-own-dogfood proof.

Two ways to use Shotcraft

Hosted web interface

Browse all six device-frame templates, preview them against sample captures, and assemble a shotcraft.config.ts in your browser. Nothing to install — drop your captures in or use the bundled samples.

CLI in your repo

Add Shotcraft as a dev dependency, point it at your dev server, and capture + render end-to-end:

pnpm add -D shotcraft \
  @shotcraft/template-app-store-iphone \
  @shotcraft/template-readme-hero
pnpm shotcraft init       # scaffold shotcraft.config.ts
pnpm shotcraft doctor     # sanity-check the config
pnpm shotcraft            # capture + render end-to-end

v1 packages are tagged in the repo; npm publishing under the @shotcraft scope is pending. Until then, install from source via the GitHub repo.

Either way, PNGs land in screenshots/{template-id}/{name}-{theme}.png, ready to upload to App Store Connect, drop into your README, or post on social.

What it does

  • Captures from your live app

    Point it at your dev server, staging URL, or production. Shotcraft logs in, drives the UI, and snaps every screen at every viewport you need — no manual screenshots, no uploads.

  • Multi-output, one config

    App Store iPhone + iPad, Play Store phone + tablet, README hero, OG card — all rendered from the same source captures in a single run.

  • Templates as code

    Visual brand lives in HTML/CSS files, version-controlled and diff-able in PRs. No vendor lock-in, no SaaS subscription, no monthly render quotas.

  • Authentic auth

    Pass a setup function with full Playwright access. Handles OAuth, email + password, magic links, JWT — anything you can script.

  • Marketplace-ready

    First-party templates ship as @shotcraft/template-* packages. Community templates publish under shotcraft-template-* and auto-discover on install.

  • Six templates out of the box

    App Store iPhone (1284×2778), App Store iPad (2064×2752), Play Store phone, Play Store tablet, README hero (1280×640), and OG / Twitter card (1200×630).

Open source & contributing

Shotcraft is MIT-licensed and built as a pnpm workspace. Templates are the place where Shotcraft most directly benefits from contributions — the package contract is small, and community templates auto-discover via shotcraft doctor.

File bugs and feature requests on GitHub. For everything else, email info@bfgsolutions.net.