Skip to content

end to end app store screenshot creation using AI

feat: bundle Apple's device bezels in the template

Parth Jadhavd88e3951f9a9
diff --git a/README.md b/README.md
index 697dff9..e343aee 100644
--- a/README.md
+++ b/README.md
@@ -121,7 +121,7 @@ project/
├── public/
│ ├── mockup.png
│ ├── app-icon.png
-│ ├── frames/ # your Apple bezels (gitignored, optional)
+│ ├── frames/ # Apple's device bezels (bundled)
│ └── screenshots/
│ ├── apple/
│ │ ├── iphone/{locale}/01.png
@@ -195,7 +195,7 @@ Uploaded files are saved under `public/screenshots/uploaded/`, and the canonical
App Store Connect has no CarPlay screenshot slot: CarPlay shots are uploaded into the iPhone slot, so the CarPlay deck exports landscape iPhone sizes with a head-unit frame.
-Each iPhone Duo display and orientation has its own deck, so portrait and landscape keep independent compositions. Landscape decks make the device the hero under a one-line headline, and **Folded + open** pairs the closed phone with the opened one. [`iphone-duo.md`](skills/app-store-screenshots/iphone-duo.md) has the design research and the rules the skill follows: the displays, what real Duo captures look like, and what the first published sets do. Use real captures from each display: a capture from another display is letterboxed, never cropped or stretched, and the editor says so. Apple's product bezels ([Apple Design Resources](https://developer.apple.com/design/resources/)) are licensed for mock-ups but not for redistribution, so they aren't bundled. Download them yourself and copy the PNGs into the project's `public/frames/`. The editor measures their screen cutouts and draws iPhone, iPad, Apple Watch, Apple TV, Mac and iPhone Duo in Apple's own frames. Without them, iPhone Duo gets a drawn frame whose screen matches the capture exactly, and the other devices keep their built-in frames. See the [template README](skills/app-store-screenshots/template/README.md#iphone-duo) for the file names.
+Each iPhone Duo display and orientation has its own deck, so portrait and landscape keep independent compositions. Landscape decks make the device the hero under a one-line headline, and **Folded + open** pairs the closed phone with the opened one. [`iphone-duo.md`](skills/app-store-screenshots/iphone-duo.md) has the design research and the rules the skill follows: the displays, what real Duo captures look like, and what the first published sets do. Use real captures from each display: a capture from another display is letterboxed, never cropped or stretched, and the editor says so. Apple's product bezels from [Apple Design Resources](https://developer.apple.com/design/resources/) ship in the template's `public/frames/`, so iPhone, iPad, Apple Watch, Apple TV, Mac and iPhone Duo are drawn in Apple's own frames. The editor measures each frame's screen cutout. Swap a file for another finish from Apple's pack. Apple licenses the bezels for mock-ups of apps for Apple platforms only. See the [template README](skills/app-store-screenshots/template/README.md#iphone-duo) for the file names.
### App Store creative assets
@@ -226,7 +226,7 @@ Mac has its own **Mac** tab because App Store Connect lists macOS as a separate
| 10" tablet landscape | 2560 x 1600 |
| Feature graphic | 1024 x 500 |
-Screenshots are designed at the largest size for each device and scaled down for smaller exports. Every export waits until each screenshot has actually painted (Safari/WebKit decodes them asynchronously) and warns instead of silently writing a blank device. Android, iPad, Apple TV, Apple Watch, CarPlay and Mac frames are CSS-rendered, iPhone uses the included `mockup.png` bezel, and iPhone Duo uses your own copy of Apple's bezels or a drawn stand-in. Every PNG is opaque 24-bit RGB with no alpha channel.
+Screenshots are designed at the largest size for each device and scaled down for smaller exports. Every export waits until each screenshot has actually painted (Safari/WebKit decodes them asynchronously) and warns instead of silently writing a blank device. Android, iPad, Apple TV, Apple Watch, CarPlay and Mac frames are CSS-rendered, iPhone uses the included `mockup.png` bezel, and Apple devices use Apple's bundled bezels. Every PNG is opaque 24-bit RGB with no alpha channel.
## Project State
diff --git a/skills/app-store-screenshots/SKILL.md b/skills/app-store-screenshots/SKILL.md
index 5735ae7..b330153 100644
--- a/skills/app-store-screenshots/SKILL.md
+++ b/skills/app-store-screenshots/SKILL.md
@@ -388,7 +388,7 @@ Ask the user these. Do not proceed until you have answers:
6. **Target stores** — Apple App Store, Mac App Store, Google Play, or a mix? Determines which platform decks to seed.
7. **iPad / Mac / Android tablet screenshots** — If yes, what sizes and orientations?
8. **Apple TV / Apple Watch / CarPlay** — Does the app have a tvOS or watchOS app, or CarPlay support? Each gets its own deck.
-9. **iPhone Duo** — Does the app support iPhone Duo? If so, read `iphone-duo.md` before planning. Ask: what does the app do differently on the inner display (two panes, sidebar, wider grid)? Which displays and orientations have their own layout? Do they have simulator captures from each display at the exact sizes? Do they have Apple's bezels (see Step 5)? Download them and accept Apple's licence only if the user explicitly asks you to; never bundle or commit them.
+9. **iPhone Duo** — Does the app support iPhone Duo? If so, read `iphone-duo.md` before planning. Ask: what does the app do differently on the inner display (two panes, sidebar, wider grid)? Which displays and orientations have their own layout? Do they have simulator captures from each display at the exact sizes? Apple's bezels for iPhone, iPad, Watch, TV, Mac and iPhone Duo ship with the template (see Step 5); ask only whether they want a different finish.
10. **App Store creative assets** — Do they want a product page header / search results asset? Default to one universal 5244×2950 asset; offer separate header and search assets only if they need different compositions. Ask for a short brand line for each; don't reuse a screenshot headline.
11. **Feature Graphic** — Want a 1024×500 Play Store banner too?
12. **Localized screenshots** — Languages? (e.g. en, de, es, pt, ja, ar, he)
@@ -433,7 +433,7 @@ Move the user's screenshots into the layout the template expects:
public/
├── app-icon.png # ← user's app icon
├── mockup.png # ← already copied by the template (iPhone bezel)
-├── frames/ # ← optional: the user's own Apple bezels (Step 5)
+├── frames/ # ← Apple's bezels, bundled; swap a file to change finish (Step 5)
└── screenshots/
├── apple/
│ ├── iphone/{locale}/01.png … N.png
@@ -711,18 +711,17 @@ Every Apple TV and Apple Watch size below was read from App Store Connect's own
- Turned poses turn the phone **left**, so the outer display's camera matches Apple's landscape bezel.
- Real captures keep the camera corner clear: iOS puts the time and status on a rail below the camera. A capture whose title sits under the camera is either hand-made or taken turned the wrong way.
- Portrait-only iPhone apps have no outer landscape: skip that deck.
-- **Apple's bezels are the user's own download.** Apple's product bezels (Apple Design Resources → Product Bezels, one `.dmg` per product) are licensed for mock-ups of apps for Apple platforms only, with no redistribution.
- - Download them and accept the licence (it appears when a `.dmg` is opened) **only when the user explicitly asks you to do that on their behalf**. Show them the licence's key terms when you do.
- - Never commit or bundle the bezels.
- - Copy the PNGs into `public/frames/` under the names in the template README's "Real bezels" table:
- - `iphone-portrait` (iPhone 18 Pro Max)
- - `ipad-portrait` (iPad Pro 13")
- - `watch` (Ultra 3)
+- **Apple's bezels ship with the template** in `public/frames/`, taken from Apple Design Resources → Product Bezels. Like fastlane frameit, the template bundles them.
+ - **Licence:** Apple licenses them for mock-ups of apps for Apple platforms only. Never use them in Android decks.
+ - **Bundled files:**
+ - `iphone-portrait` (iPhone 18 Pro Max, Black)
+ - `ipad-portrait` (iPad Pro 13", Space Black)
+ - `watch` (Ultra 3, Ocean Band)
- `tv` (Apple TV 4K)
- - `mac` (MacBook Air 15")
- - `duo-outer-portrait`, `duo-inner-portrait`, and optionally the `-landscape` variants
- - The editor measures each file's transparent screen cutout and uses the bezel for that device; the App Store creatives use the iPhone bezel. `public/frames/*.png` is gitignored.
- - Without a file, Duo uses a drawn frame and every other device keeps its built-in frame. Android and CarPlay never use Apple bezels.
+ - `mac` (MacBook Air 15", Midnight)
+ - `duo-outer-portrait`, `duo-outer-landscape`, `duo-inner-portrait` and `duo-inner-landscape` (Night Sky)
+ - **Another finish or model:** replace the file with another PNG from Apple's pack under the same name. The editor measures each file's transparent screen cutout per corner, and uses the bezel for that device; the App Store creatives use the iPhone bezel.
+ - **Without a file:** Duo uses a drawn frame and every other device keeps its built-in frame. Android and CarPlay never use Apple bezels.
### App Store creative assets
@@ -784,7 +783,7 @@ Every Apple TV and Apple Watch size below was read from App Store Connect's own
| Reset wiped the deck | Reset clears in-memory state and re-saves defaults to `app-store-screenshots.json`. Recover by `git checkout app-store-screenshots.json` if it was committed, or export first before resetting. |
| Export is blank | Check the export toast for a "may be missing" warning and re-export; otherwise the source PNG probably has alpha — flatten to RGB |
| Looked for a CarPlay slot in App Store Connect | There isn't one — upload CarPlay shots into the iPhone slot |
-| Committed or bundled Apple's bezels | Remove them: the licence forbids redistribution. The user keeps their own copy in gitignored `public/frames/` |
+| Used an Apple bezel on an Android deck | Apple licenses its bezels for Apple platforms only; Android decks keep the built-in frames |
| Turned a Duo portrait deck into landscape by editing transforms | Use the Orientation menu: landscape is a separate deck, so both compositions survive |
| Resized iPhone captures to Duo sizes, or used the inner capture on the outer deck | Capture each display in Xcode 27.1's simulator at its exact size (`scripts/capture-iphone-duo.sh`); the editor letterboxes anything else |
| The bezel's camera covers the clock or a title on an outer-display slide | The capture isn't real, or the phone was turned right. Real captures put the status rail under the camera; capture turned poses turned left |
diff --git a/skills/app-store-screenshots/iphone-duo.md b/skills/app-store-screenshots/iphone-duo.md
index 07b398c..75e685e 100644
--- a/skills/app-store-screenshots/iphone-duo.md
+++ b/skills/app-store-screenshots/iphone-duo.md
@@ -229,9 +229,9 @@ ASO write-ups add a few more rules, unproven but consistent with this:
the other.
- **Never crop the trailing rail off a capture.** It is where the app's controls
live.
-- **Never download Apple's bezels or accept their licence for the user unless
- they explicitly ask, and never commit them.** The licence allows mock-ups only,
- with no redistribution. See SKILL.md Step 5.
+- **Never use Apple's bezels outside Apple-platform mock-ups.** The template
+ bundles them (see SKILL.md Step 5). Apple licenses them only for mock-ups of
+ apps for Apple platforms, so never use them for Android.
### QA before export
diff --git a/skills/app-store-screenshots/template/.gitignore b/skills/app-store-screenshots/template/.gitignore
index 153dc29..e9ef83b 100644
--- a/skills/app-store-screenshots/template/.gitignore
+++ b/skills/app-store-screenshots/template/.gitignore
@@ -17,6 +17,3 @@ public/fonts/imported/*
# Tester Army output
.e2e/
-# iPhone Duo bezels from Apple Design Resources. Apple's licence forbids
-# redistributing them, so each user adds their own copy (see README).
-public/frames/*.png
diff --git a/skills/app-store-screenshots/template/README.md b/skills/app-store-screenshots/template/README.md
index 95c8ca6..e4cf09e 100644
--- a/skills/app-store-screenshots/template/README.md
+++ b/skills/app-store-screenshots/template/README.md
@@ -17,7 +17,7 @@ bun dev # http://localhost:3000
- **Screen controls** — drag-to-reorder screens, click-to-edit text, screenshot drop targets, per-screen layout switcher, dark/light toggle.
- **Style Lab and Scene Playground** — compare complete looks for a deck and restyle every screen's backdrop, depth and headline at once. See [Style Lab](#style-lab) and [Scene Playground](#scene-playground).
- **Image overlays, fonts, backgrounds and undo** — PNG/JPG overlay elements, a live screenshot font menu (with font import), per-screen custom backgrounds, and toolbar Undo/Redo. See [Editor controls](#editor-controls).
-- **Device frames** (`src/components/editor/device-frames.tsx`) — iPhone (PNG mockup), iPhone Duo outer and inner displays (a drawn frame), iPad, Apple TV, Apple Watch, CarPlay head unit, Mac window, Android phone, Android tablet (portrait + landscape), feature graphic. Apple's own bezels, if you add them to `public/frames/`, replace the built-in iPhone, iPad, Apple Watch, Apple TV, Mac and iPhone Duo frames (see Real bezels).
+- **Device frames** (`src/components/editor/device-frames.tsx`) — iPhone (PNG mockup), iPhone Duo outer and inner displays (a drawn frame), iPad, Apple TV, Apple Watch, CarPlay head unit, Mac window, Android phone, Android tablet (portrait + landscape), feature graphic. Apple's own bezels in `public/frames/` (bundled) replace the built-in iPhone, iPad, Apple Watch, Apple TV, Mac and iPhone Duo frames (see Real bezels).
- **Auto-save (git-trackable)** — every change is persisted within ~600ms to **`app-store-screenshots.json`** at the project root (via `/api/project`) **and** mirrored to `localStorage` as an instant-paint cache. Commit `app-store-screenshots.json` and you can `git clone` to another machine and resume exactly where you left off.
- **Multi-device decks** — iOS (iPhone, iPad, iPhone Duo outer/inner in portrait and landscape, Apple TV, Apple Watch, CarPlay, App Store creative assets), Mac, and Android decks live side by side; switching the platform tab keeps each tab's last device.
- **One-click export** — bulk PNG export at any required App Store / Play Store resolution using `html-to-image`; each PNG is rendered from the current connected or isolated deck mode.
@@ -78,27 +78,27 @@ Use real captures from each display. A capture whose aspect doesn't match the di
On a real capture the outer display's status and controls sit on a rail below the camera, so Apple's bezel covers nothing. Turned poses are taken with the phone turned left, matching Apple's landscape bezel.
-**Real bezels.** Apple publishes product bezels in [Apple Design Resources](https://developer.apple.com/design/resources/) (Product Bezels). Their licence allows using them to make mock-ups of apps for Apple platforms, but not redistributing them or using them for apps on other platforms. This template doesn't ship them. To use them, download the packs, accept Apple's licence (it appears when you open each `.dmg`), and copy PNGs from the packs' `PNG` folders into `public/frames/` with these names:
+**Real bezels.** The template ships Apple's product bezels from [Apple Design Resources](https://developer.apple.com/design/resources/) (Product Bezels) in `public/frames/`. Apple licenses them for making mock-ups of apps for Apple platforms, so never use them for other platforms. To change a finish or model, download Apple's pack and replace the file under the same name:
-| File | Device | Apple pack and PNG (screen cutout) |
+| File | Device | Bundled PNG from Apple's pack (screen cutout) |
|------|--------|-------------------------------------|
-| `iphone-portrait.png` | iPhone, and the iPhone in App Store creatives | iPhone 18 → iPhone 18 Pro Max, Portrait (1320 × 2868) |
-| `ipad-portrait.png` | iPad | iPad Pro (M5) → 13", Portrait (2064 × 2752) |
-| `watch.png` | Apple Watch | Apple Watch Ultra 3 (422 × 514) |
+| `iphone-portrait.png` | iPhone, and the iPhone in App Store creatives | iPhone 18 → iPhone 18 Pro Max, Black, Portrait (1320 × 2868) |
+| `ipad-portrait.png` | iPad | iPad Pro (M5) → 13", Space Black, Portrait (2064 × 2752) |
+| `watch.png` | Apple Watch | Apple Watch Ultra 3 → Black + Ocean Band Black (422 × 514) |
| `tv.png` | Apple TV | Apple TV → Apple TV - 4K (3840 × 2160) |
-| `mac.png` | Mac | MacBook Air M5 → 15-inch (2880 × 1864) |
-| `duo-outer-portrait.png` | iPhone Duo outer, portrait | iPhone Duo → Outer Closed Portrait (1398 × 2034) |
-| `duo-outer-landscape.png` | iPhone Duo outer, landscape | iPhone Duo → Outer Closed Landscape (optional: the portrait file is turned if absent) |
-| `duo-inner-portrait.png` | iPhone Duo inner, portrait | iPhone Duo → Inner Open Portrait (2007 × 2853) |
-| `duo-inner-landscape.png` | iPhone Duo inner, landscape | iPhone Duo → Inner Open Landscape (optional) |
+| `mac.png` | Mac | MacBook Air M5 → 15-inch Midnight (2880 × 1864) |
+| `duo-outer-portrait.png` | iPhone Duo outer, portrait | iPhone Duo → Night Sky, Outer Closed Portrait (1398 × 2034) |
+| `duo-outer-landscape.png` | iPhone Duo outer, landscape | iPhone Duo → Night Sky, Outer Closed Landscape (if removed, the portrait file is turned) |
+| `duo-inner-portrait.png` | iPhone Duo inner, portrait | iPhone Duo → Night Sky, Inner Open Portrait (2007 × 2853) |
+| `duo-inner-landscape.png` | iPhone Duo inner, landscape | iPhone Duo → Night Sky, Inner Open Landscape (2853 × 2007) |
-Any finish or band works. Each file listed has a screen cutout exactly the size of that deck's capture, except the Mac. No MacBook screen is 16:10, so a 2880 × 1800 Mac capture fills the MacBook Air 15" screen from the top and loses about 3% at the bottom. A capture taken on that MacBook fits exactly.
+Any finish or band works as a replacement. Each file listed has a screen cutout exactly the size of that deck's capture, except the Mac. No MacBook screen is 16:10, so a 2880 × 1800 Mac capture fills the MacBook Air 15" screen from the top and loses about 3% at the bottom. A capture taken on that MacBook fits exactly.
`/api/frames` measures each file's transparent screen cutout, and the editor draws the capture under the bezel. Cameras, corners and cutouts therefore come from Apple's artwork, and devices are placed using the bezel's real aspect ratio.
- Reload the editor after adding or replacing a file.
- A file whose centre isn't transparent is reported in a toast and skipped.
-- `public/frames/*.png` is gitignored; keep the files out of public repositories.
+- Like fastlane frameit's frames, the bezels are bundled so every project gets real frames out of the box.
- 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.
- CarPlay and Android always use built-in frames: Apple publishes no head-unit bezel, and the licence doesn't cover other platforms.
diff --git a/skills/app-store-screenshots/template/docs/testing/e2e.md b/skills/app-store-screenshots/template/docs/testing/e2e.md
index 8b19797..b520389 100644
--- a/skills/app-store-screenshots/template/docs/testing/e2e.md
+++ b/skills/app-store-screenshots/template/docs/testing/e2e.md
@@ -155,7 +155,7 @@ This pass added Duo-specific placements, the **Folded + open** pair and new star
### Apple bezels (7 October 2026)
-The editor now draws iPhone, iPad, Apple Watch, Apple TV, Mac, App Store creatives and iPhone Duo under Apple's own bezels when they are in `public/frames/` (see the template README, Real bezels). The test server (`e2e-army/server.cjs`) leaves `public/frames/*.png` out of its disposable workspace, so every machine tests the same product as a fresh clone. With the bezels copied in, Scene Playground steps took longer than the 500 ms undo-grouping window under the harness, which made the undo test depend on the machine.
+The editor now draws iPhone, iPad, Apple Watch, Apple TV, Mac, App Store creatives and iPhone Duo under Apple's own bezels when they are in `public/frames/` (see the template README, Real bezels). The bezels are now bundled in `public/frames/`, so the test server copies them and every suite run covers the shipped frames. With them in place, Scene Playground steps first took longer than the 500 ms undo-grouping window. The cause: `DeviceDepth` changed its element tree when shadow, glow or tilt toggled, remounting every frame and re-decoding its bezel. The wrapper is now always the same shape, and the undo test passes with the bezels in place.
| Check | Result |
| --- | --- |
diff --git a/skills/app-store-screenshots/template/e2e-army/server.cjs b/skills/app-store-screenshots/template/e2e-army/server.cjs
index 6787dfb..163c009 100644
--- a/skills/app-store-screenshots/template/e2e-army/server.cjs
+++ b/skills/app-store-screenshots/template/e2e-army/server.cjs
@@ -6,12 +6,8 @@ const path = require('node:path');
const { spawn } = require('node:child_process');
const source = path.resolve(__dirname, '..');
const workspace = mkdtempSync(path.join(tmpdir(), 'screenshots-e2e-'));
-// Apple bezels a user added to public/frames/ are left out too, so every
-// machine tests the same product as a fresh clone (they're gitignored).
cpSync(source, workspace, { recursive: true, filter: p => {
- const rel = path.relative(source, p);
- const first = rel.split(path.sep)[0];
- if (path.dirname(rel) === path.join('public', 'frames') && rel.endsWith('.png')) return false;
+ const first = path.relative(source, p).split(path.sep)[0];
return !['node_modules', '.next', '.e2e', '.git', 'tests', 'e2e-army'].includes(first);
}});
symlinkSync(path.join(source, 'node_modules'), path.join(workspace, 'node_modules'), 'dir');
diff --git a/skills/app-store-screenshots/template/public/frames/duo-inner-landscape.png b/skills/app-store-screenshots/template/public/frames/duo-inner-landscape.png
new file mode 100644
index 0000000..ecee043
Binary files /dev/null and b/skills/app-store-screenshots/template/public/frames/duo-inner-landscape.png differ
diff --git a/skills/app-store-screenshots/template/public/frames/duo-inner-portrait.png b/skills/app-store-screenshots/template/public/frames/duo-inner-portrait.png
new file mode 100644
index 0000000..bfe9f54
Binary files /dev/null and b/skills/app-store-screenshots/template/public/frames/duo-inner-portrait.png differ
diff --git a/skills/app-store-screenshots/template/public/frames/duo-outer-landscape.png b/skills/app-store-screenshots/template/public/frames/duo-outer-landscape.png
new file mode 100644
index 0000000..c09ead5
Binary files /dev/null and b/skills/app-store-screenshots/template/public/frames/duo-outer-landscape.png differ
diff --git a/skills/app-store-screenshots/template/public/frames/duo-outer-portrait.png b/skills/app-store-screenshots/template/public/frames/duo-outer-portrait.png
new file mode 100644
index 0000000..4909828
Binary files /dev/null and b/skills/app-store-screenshots/template/public/frames/duo-outer-portrait.png differ
diff --git a/skills/app-store-screenshots/template/public/frames/ipad-portrait.png b/skills/app-store-screenshots/template/public/frames/ipad-portrait.png
new file mode 100644
index 0000000..889ac54
Binary files /dev/null and b/skills/app-store-screenshots/template/public/frames/ipad-portrait.png differ
diff --git a/skills/app-store-screenshots/template/public/frames/iphone-portrait.png b/skills/app-store-screenshots/template/public/frames/iphone-portrait.png
new file mode 100644
index 0000000..3ad6fb2
Binary files /dev/null and b/skills/app-store-screenshots/template/public/frames/iphone-portrait.png differ
diff --git a/skills/app-store-screenshots/template/public/frames/mac.png b/skills/app-store-screenshots/template/public/frames/mac.png
new file mode 100644
index 0000000..afce0de
Binary files /dev/null and b/skills/app-store-screenshots/template/public/frames/mac.png differ
diff --git a/skills/app-store-screenshots/template/public/frames/tv.png b/skills/app-store-screenshots/template/public/frames/tv.png
new file mode 100644
index 0000000..79cb4c4
Binary files /dev/null and b/skills/app-store-screenshots/template/public/frames/tv.png differ
diff --git a/skills/app-store-screenshots/template/public/frames/watch.png b/skills/app-store-screenshots/template/public/frames/watch.png
new file mode 100644
index 0000000..a298647
Binary files /dev/null and b/skills/app-store-screenshots/template/public/frames/watch.png differ
diff --git a/skills/app-store-screenshots/template/src/app/frames/[filename]/route.ts b/skills/app-store-screenshots/template/src/app/frames/[filename]/route.ts
index 7deb283..d0de14e 100644
--- a/skills/app-store-screenshots/template/src/app/frames/[filename]/route.ts
+++ b/skills/app-store-screenshots/template/src/app/frames/[filename]/route.ts
@@ -6,7 +6,7 @@ import { FRAME_FILES } from "@/lib/frame-assets";
export const dynamic = "force-dynamic";
// Served at runtime: Next's production public-file index only covers files
-// that existed at build time, and bezels are added by the user afterwards.
+// that existed at build time, and bezels may be swapped afterwards.
export async function GET(_req: Request, context: { params: Promise<{ filename: string }> }) {
const { filename } = await context.params;
const name = filename.replace(/\.png$/, "");
diff --git a/skills/app-store-screenshots/template/src/components/editor/device-frames.tsx b/skills/app-store-screenshots/template/src/components/editor/device-frames.tsx
index 256597c..e1f3599 100644
--- a/skills/app-store-screenshots/template/src/components/editor/device-frames.tsx
+++ b/skills/app-store-screenshots/template/src/components/editor/device-frames.tsx
@@ -347,10 +347,10 @@ export function IPad({ src, alt = "", style, hideEmpty }: FrameProps) {
}
// ---------- iPhone Duo ----------
-// Geometry comes from the user's own copy of Apple's bezel (measured by
+// Geometry comes from Apple's bezel in public/frames/ (measured by
// /api/frames) or, without one, a drawn frame whose screen has the capture's
// exact aspect. The frame fits itself inside whatever box it is given, so a
-// placement saved before a bezel was added never stretches it.
+// placement saved with a different bezel never stretches it.
// A capture whose aspect is off by more than this is letterboxed rather than
// cropped: cropping would cut real UI, which is worse than a visible bar.
diff --git a/skills/app-store-screenshots/template/src/components/editor/scene-layers.tsx b/skills/app-store-screenshots/template/src/components/editor/scene-layers.tsx
index 39d151c..d3e59bd 100644
--- a/skills/app-store-screenshots/template/src/components/editor/scene-layers.tsx
+++ b/skills/app-store-screenshots/template/src/components/editor/scene-layers.tsx
@@ -301,7 +301,11 @@ function SceneDecor({
// ---------- Device depth ----------
-/** Shadow, glow and 3D tilt around a device frame. Classic scenes render the frame untouched. */
+/**
+ * Shadow, glow and 3D tilt around a device frame. The wrapper is always the
+ * same shape, even in classic scenes, so toggling depth never remounts the
+ * frame and re-decodes its (large) bezel image.
+ */
export function DeviceDepth({
scene,
cW,
@@ -313,7 +317,6 @@ export function DeviceDepth({
accent: string;
children: React.ReactNode;
}) {
- if (!scene.shadow && !scene.glow && !scene.tilt) return <>{children}</>;
const s = scene.shadow / 100;
const g = scene.glow / 100;
return (
diff --git a/skills/app-store-screenshots/template/src/lib/frame-assets.ts b/skills/app-store-screenshots/template/src/lib/frame-assets.ts
index 580d327..905219a 100644
--- a/skills/app-store-screenshots/template/src/lib/frame-assets.ts
+++ b/skills/app-store-screenshots/template/src/lib/frame-assets.ts
@@ -1,13 +1,12 @@
// Device frame geometry from Apple's product bezels.
//
-// Apple's bezels (developer.apple.com/design/resources, Product Bezels) are
-// licensed for making mock-ups of apps for Apple platforms, not for
-// redistribution, so this repository does not ship them. Each user downloads the
-// packs, accepts Apple's licence and copies the PNGs into public/frames/ (see
-// README). /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.
+// 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";