Skip to content

oberconcejo/VS-CODE / .agents/skills/app-store-screenshots

app-store-screenshots

Flagged

Use when building App Store or Google Play screenshot pages, generating exportable marketing screenshots for iOS, macOS, and/or Android apps, or scaffolding a screenshot editor with Next.js. Triggers on app store, mac app store, play store, screenshots, marketing assets, html-to-image, phone mockup, mac mockup, android screenshots, feature graphic.

FileKindSize
SKILL.mdskill md63.5 KB
copy-ideas.mdmarkdown8.9 KB
iphone-duo.mdmarkdown13.8 KB
mockup.pngbinary92.8 KB
scripts/capture-iphone-duo.shscript7.0 KB
style-prompts.mdmarkdown10.2 KB
style-prompts/01-retro-rubberhose-mascot.mdmarkdown24.7 KB
style-prompts/02-moody-curated-dating.mdmarkdown27.0 KB
style-prompts/03-paper-sticker-skeuomorphic.mdmarkdown28.3 KB
style-prompts/04-dreamy-pastel-couples.mdmarkdown24.7 KB
style-prompts/05-hand-drawn-editorial-tasks.mdmarkdown23.5 KB
style-prompts/06-glossy-3d-kbeauty-creator.mdmarkdown21.1 KB
style-prompts/07-liquid-glass-aurora.mdmarkdown19.8 KB
style-prompts/08-swiss-grid-bold.mdmarkdown20.0 KB
style-prompts/09-neon-athletic-night.mdmarkdown22.3 KB
style-prompts/10-magazine-cover-editorial.mdmarkdown25.2 KB
style-prompts/11-candy-pop-social.mdmarkdown19.9 KB
style-prompts/12-soft-clay-wellness.mdmarkdown20.6 KB
style-prompts/13-midnight-glow-pro.mdmarkdown33.7 KB
style-prompts/14-risograph-zine.mdmarkdown35.0 KB
style-prompts/15-bento-keynote-grid.mdmarkdown31.3 KB
style-prompts/16-toybox-primary.mdmarkdown35.2 KB
style-prompts/17-quiet-japandi.mdmarkdown30.0 KB
style-prompts/18-vintage-travel-poster.mdmarkdown37.6 KB
style-prompts/_QUALITY_BAR.mdmarkdown13.6 KB
template/.github/workflows/e2e.ymlconfig783 B
template/.gitignoreother470 B
template/README.mdmarkdown24.1 KB
template/app-store-screenshots.jsonconfig8.3 KB
template/bun.lockother71.9 KB
template/components.jsonconfig449 B
template/docs/testing/e2e.mdmarkdown23.5 KB
template/e2e-army/chrome-provider.tsscript1.7 KB
template/e2e-army/server.cjsscript1.6 KB
template/e2e.config.tsscript824 B
template/next.config.mjsscript294 B
template/package.jsonmanifest1.6 KB
template/postcss.config.mjsscript81 B
template/public/fonts/imported/.gitkeepother1 B
template/public/frames/.gitkeepother0 B
template/public/frames/duo-inner-landscape.pngbinary777.3 KB
template/public/frames/duo-inner-portrait.pngbinary802.5 KB
template/public/frames/duo-outer-landscape.pngbinary371.9 KB
template/public/frames/duo-outer-portrait.pngbinary446.3 KB
template/public/frames/ipad-portrait.pngbinary307.1 KB
template/public/frames/iphone-portrait.pngbinary478.4 KB
template/public/frames/mac.pngbinary660.7 KB
template/public/frames/tv.pngbinary833.9 KB
template/public/frames/watch.pngbinary234.3 KB
template/public/mockup.pngbinary92.8 KB
template/public/screenshots/android/phone/en/.gitkeepother0 B
template/public/screenshots/apple/ipad/en/.gitkeepother0 B
template/public/screenshots/apple/iphone/en/.gitkeepother0 B
template/src/app/api/frames/route.tsscript1.5 KB
template/src/app/api/project/route.tsscript3.4 KB
template/src/app/api/upload-font/route.tsscript4.5 KB
template/src/app/api/upload/route.tsscript3.2 KB
template/src/app/fonts/imported/[filename]/route.tsscript359 B
template/src/app/frames/[filename]/route.tsscript1.3 KB
template/src/app/globals.cssother3.2 KB
template/src/app/layout.tsxother487 B
template/src/app/page.tsxother141 B
template/src/app/screenshots/uploaded/[filename]/route.tsscript328 B
template/src/components/editor/background-controls.tsxother2.9 KB
template/src/components/editor/callout-controls.tsxother7.9 KB
template/src/components/editor/create-image-mask.tsscript586 B
template/src/components/editor/device-frames.tsxother20.9 KB
template/src/components/editor/font-importer.tsxother3.0 KB
template/src/components/editor/image-element-canvas.tsxother1.4 KB
template/src/components/editor/inspector.tsxother40.9 KB
template/src/components/editor/preview-stage.tsxother10.4 KB
template/src/components/editor/scene-layers.tsxother14.3 KB
template/src/components/editor/scene-playground.tsxother10.5 KB
template/src/components/editor/screenshot-editor.tsxother37.6 KB
template/src/components/editor/screenshot-picker.tsxother7.2 KB
template/src/components/editor/sidebar.tsxother4.3 KB
template/src/components/editor/slide-canvas.tsxother54.9 KB
template/src/components/editor/slide-thumb.tsxother5.9 KB
template/src/components/editor/style-lab.tsxother17.4 KB
template/src/components/editor/toolbar.tsxother14.7 KB
template/src/components/ui/button.tsxother1.8 KB
template/src/components/ui/card.tsxother1.2 KB
template/src/components/ui/dialog.tsxother3.1 KB
template/src/components/ui/dropdown-menu.tsxother3.7 KB
template/src/components/ui/input.tsxother717 B
template/src/components/ui/label.tsxother714 B
template/src/components/ui/popover.tsxother1.0 KB
template/src/components/ui/select.tsxother3.7 KB
template/src/components/ui/tabs.tsxother1.9 KB
template/src/components/ui/textarea.tsxother644 B
template/src/components/ui/tooltip.tsxother898 B
template/src/lib/clean-hex-color.tsscript225 B
template/src/lib/clean-imported-font.tsscript990 B
template/src/lib/constants.tsscript21.9 KB
template/src/lib/contrast.tsscript3.0 KB
template/src/lib/copy-ideas.tsscript2.9 KB
template/src/lib/defaults.tsscript9.2 KB
template/src/lib/elements.tsscript1.3 KB
template/src/lib/export-assets.tsscript1.3 KB
template/src/lib/export-render.tsscript8.9 KB
template/src/lib/frame-assets.tsscript7.7 KB
template/src/lib/image-cache.tsscript3.0 KB
template/src/lib/locale.tsscript1.9 KB
template/src/lib/measure-frame.tsscript3.6 KB
template/src/lib/png-encode.tsscript2.9 KB
template/src/lib/png-rgb.tsscript5.4 KB
template/src/lib/png-worker.tsscript545 B
template/src/lib/project-validation.tsscript4.9 KB
template/src/lib/request-body.tsscript1.7 KB
template/src/lib/request-guard.tsscript2.0 KB
template/src/lib/scene.tsscript4.7 KB
template/src/lib/serve-asset.tsscript1.0 KB
template/src/lib/storage.tsscript16.5 KB
template/src/lib/style-lab.tsscript13.1 KB
template/src/lib/types.tsscript7.4 KB
template/src/lib/typography.tsscript2.0 KB
template/src/lib/utils.tsscript169 B
template/src/lib/write-asset.tsscript448 B
template/tailwind.config.tsscript2.0 KB
template/tests/editor.e2e.tsscript12.5 KB
template/tests/harness/api-bug-bash.cjsscript9.5 KB
template/tests/harness/bug-bash.cjsscript34.9 KB
template/tests/harness/migration-fixture.cjsscript7.4 KB
template/tests/harness/run.cjsscript466 B
template/tests/harness/ui-bug-bash.cjsscript14.9 KB
template/tests/regression.e2e.tsscript1.5 KB
template/tests/scene-style-lab.e2e.tsscript14.7 KB
template/tests/targets.e2e.tsscript12.5 KB
template/tsconfig.jsonconfig594 B

template/src/lib/frame-assets.ts

View on GitHub
// Device frame geometry from Apple's product bezels.
//
// Apple's bezels (developer.apple.com/design/resources, Product Bezels) ship in
// public/frames/; swapping a file changes the finish (see README). Apple
// licenses them for mock-ups of apps for Apple platforms. /api/frames measures
// each PNG's transparent screen cutout and the editor draws the screenshot under
// the real bezel. Without a file, iPhone Duo uses a drawn frame whose screen has
// the exact capture aspect, and every other device keeps its built-in frame.
// Android and CarPlay never use Apple bezels.
import { DUO_INNER_SCREEN, DUO_OUTER_SCREEN } from "./constants";
import type { Device } from "./types";

export type DuoDevice = Extract<Device, `duo-${string}`>;

/** File names (without .png) looked for in public/frames/. */
export const FRAME_FILES = [
  "iphone-portrait",
  "ipad-portrait",
  "watch",
  "tv",
  "mac",
  "duo-outer-portrait",
  "duo-outer-landscape",
  "duo-inner-portrait",
  "duo-inner-landscape",
] as const;
export type FrameFile = (typeof FRAME_FILES)[number];

const DUO_SOURCES: Record<DuoDevice, { file: FrameFile; rotateFrom?: FrameFile }> = {
  "duo-outer": { file: "duo-outer-portrait" },
  "duo-outer-landscape": { file: "duo-outer-landscape", rotateFrom: "duo-outer-portrait" },
  "duo-inner": { file: "duo-inner-portrait" },
  "duo-inner-landscape": { file: "duo-inner-landscape", rotateFrom: "duo-inner-portrait" },
};

/**
 * Which file draws each device, and which portrait file can be turned instead.
 * App Store creatives show an iPhone, so they use the iPhone bezel.
 */
const FRAME_SOURCES: Partial<Record<Device, { file: FrameFile; rotateFrom?: FrameFile }>> = {
  iphone: { file: "iphone-portrait" },
  ipad: { file: "ipad-portrait" },
  watchos: { file: "watch" },
  tvos: { file: "tv" },
  mac: { file: "mac" },
  "creative-universal": { file: "iphone-portrait" },
  "creative-header": { file: "iphone-portrait" },
  "creative-search": { file: "iphone-portrait" },
  ...DUO_SOURCES,
};

type PixelRect = { x: number; y: number; w: number; h: number };

/** A bezel PNG measured by /api/frames: its size and transparent screen cutout. */
export type MeasuredFrame = {
  src: string;
  width: number;
  height: number;
  screen: PixelRect;
  /** Largest corner radius of the cutout in image pixels. */
  radius: number;
  /** Each corner's radius in image pixels: top-left, top-right, bottom-right, bottom-left. */
  radii?: [number, number, number, number];
};

export type FrameGeometry = {
  /** Frame width / height. */
  aspect: number;
  /** Screen rect as percentages of the frame. */
  screen: { L: number; T: number; W: number; H: number };
  /** Screen corner radius as percentages of the screen's width and height. */
  radius: { x: number; y: number };
  /** CSS border-radius clipping the capture to a bezel cutout whose corners differ. */
  clip?: string;
  /** Screen width / height. */
  screenAspect: number;
  /** The real bezel, drawn over the screen. `rotate` turns a portrait file to landscape. */
  image?: { src: string; rotate: boolean };
  /**
   * Camera drawn on the stand-in frame. The outer display has a front camera in
   * its top trailing corner; the inner display's FaceTime camera sits under the
   * screen, so nothing is drawn there (nor a crease: captures show none).
   */
  camera: "corner" | "none";
};

let measured: Partial<Record<FrameFile, MeasuredFrame>> = {};

/** Install the frames measured by /api/frames. Call before rendering any deck. */
export function setFrameAssets(next: Partial<Record<FrameFile, MeasuredFrame>>) {
  measured = { ...next };
}

/** Bezel image URLs in use, so they can be preloaded for export. */
export function frameAssetPaths(device?: Device): string[] {
  // A Duo deck also draws its companion display in "Folded + open".
  const devices = (device
    ? isDuoDevice(device) ? [device, DUO_COMPANION[device]] : [device]
    : Object.keys(FRAME_SOURCES)) as Device[];
  return devices.flatMap((d) => {
    const image = bezelGeometry(d)?.image;
    return image ? [image.src] : [];
  });
}

export function isDuoDevice(device: Device): device is DuoDevice {
  return Object.hasOwn(DUO_SOURCES, device);
}

/**
 * Frame geometry for a device drawn under an Apple bezel: always for iPhone Duo
 * (measured or drawn), otherwise only when the user has added that bezel.
 */
export function bezelGeometry(device: Device): FrameGeometry | null {
  if (isDuoDevice(device)) return duoGeometry(device);
  const source = FRAME_SOURCES[device];
  const frame = source && measured[source.file];
  return frame ? fromMeasured(frame, false, "none") : null;
}

export function duoGeometry(device: DuoDevice): FrameGeometry {
  const { file, rotateFrom } = DUO_SOURCES[device];
  const inner = device.startsWith("duo-inner");
  const camera = inner ? "none" : "corner";
  const direct = measured[file];
  if (direct) return fromMeasured(direct, false, camera);
  const turned = rotateFrom ? measured[rotateFrom] : undefined;
  if (turned) return fromMeasured(turned, true, camera);
  const portrait = inner ? DUO_INNER_SCREEN : DUO_OUTER_SCREEN;
  return drawnGeometry(device.endsWith("-landscape") ? 1 / portrait : portrait, inner, camera);
}

function fromMeasured(frame: MeasuredFrame, rotate: boolean, camera: FrameGeometry["camera"]): FrameGeometry {
  // Turning counter-clockwise maps image point (x, y) to (y, width - x).
  const width = rotate ? frame.height : frame.width;
  const height = rotate ? frame.width : frame.height;
  const s = frame.screen;
  const screen = rotate ? { x: s.y, y: frame.width - (s.x + s.w), w: s.h, h: s.w } : s;
  return {
    aspect: width / height,
    screen: {
      L: (screen.x / width) * 100,
      T: (screen.y / height) * 100,
      W: (screen.w / width) * 100,
      H: (screen.h / height) * 100,
    },
    radius: { x: (frame.radius / screen.w) * 100, y: (frame.radius / screen.h) * 100 },
    clip: frame.radii && cornerClip(frame.radii, rotate, screen.w, screen.h),
    screenAspect: screen.w / screen.h,
    image: { src: frame.src, rotate },
    camera,
  };
}

// Clips the capture to the cutout's own corners, so a square corner shows the
// capture to the edge and a large one never pokes past the bezel's body.
function cornerClip(radii: [number, number, number, number], rotate: boolean, w: number, h: number) {
  // Turning counter-clockwise moves each corner one place round: the old
  // top-right becomes the top-left, and so on.
  const [tl, tr, br, bl] = rotate ? [radii[1], radii[2], radii[3], radii[0]] : radii;
  const xs = [tl, tr, br, bl].map((r) => `${(r / w) * 100}%`).join(" ");
  const ys = [tl, tr, br, bl].map((r) => `${(r / h) * 100}%`).join(" ");
  return `${xs} / ${ys}`;
}

// Drawn stand-in: an even bezel around a screen of exactly the capture aspect.
function drawnGeometry(screenAspect: number, inner: boolean, camera: FrameGeometry["camera"]): FrameGeometry {
  const sw = screenAspect;
  const sh = 1;
  const short = Math.min(sw, sh);
  const bezel = short * 0.028;
  const fw = sw + bezel * 2;
  const fh = sh + bezel * 2;
  const r = short * (inner ? 0.07 : 0.1);
  return {
    aspect: fw / fh,
    screen: { L: (bezel / fw) * 100, T: (bezel / fh) * 100, W: (sw / fw) * 100, H: (sh / fh) * 100 },
    radius: { x: (r / sw) * 100, y: (r / sh) * 100 },
    screenAspect,
    camera,
  };
}

/**
 * The same phone in its other state, for the "Folded + open" layout. Opening a
 * closed phone held upright gives the inner display in landscape (the fold runs
 * down the middle); opening it held sideways gives the inner display in portrait.
 */
export const DUO_COMPANION: Record<DuoDevice, DuoDevice> = {
  "duo-outer": "duo-inner-landscape",
  "duo-inner-landscape": "duo-outer",
  "duo-outer-landscape": "duo-inner",
  "duo-inner": "duo-outer-landscape",
};
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall