Options reference
A flat, copy-pasteable catalog of every field the render engine accepts and every value it allows, with defaults. This is the machine-readable companion to openapi.json (the authoritative contract) and the visual gallery. Styling resolves in a cascade: preset → theme → slide → slide.devices[], each step overriding the last. Every field is optional.
Resolution order, last wins: preset (a named look) → theme (set-wide locked tokens) → slide.theme (per-slide theme override) → slide fields → slide.devices[] (per-device override in multi-device slides). Theme tokens are deliberately locked across the whole set (one background, one type scale, one device treatment) so the output reads as one store listing.
canvas.preset picks an exact store dimension, or pass a custom canvas.width / canvas.height (320-4096 px each) for marketing sizes. Default: appstore.iphone_6_9.
| canvas.preset | Output px | Store target |
|---|---|---|
| appstore.iphone_6_9 | 1290 × 2796 | iPhone 6.9" (default) |
| appstore.iphone_6_9_alt_1260 | 1260 × 2736 | iPhone 6.9" alt |
| appstore.iphone_6_9_alt_1320 | 1320 × 2868 | iPhone 6.9" alt (M4 iPad point size) |
| appstore.iphone_6_5 | 1284 × 2778 | iPhone 6.5" |
| appstore.iphone_6_5_alt_1242 | 1242 × 2688 | iPhone 6.5" alt |
| appstore.ipad_13 | 2064 × 2752 | iPad 13" |
| play.phone | 1080 × 1920 | Google Play phone (portrait) |
| play.phone_landscape | 1920 × 1080 | Google Play phone (landscape) |
| googleplay.phone_portrait | 1080 × 1920 | alias → play.phone |
| googleplay.phone_landscape | 1920 × 1080 | alias → play.phone_landscape |
preset applies a full look in one token. 17 presets; see them rendered. Each is a partial theme, so any theme / slide field overrides on top.
| preset | Background | Headline | Frame / shadow |
|---|---|---|---|
| aurora-midnight | dark aurora mesh | bold-light | real · high |
| forest-fraunces | green gradient | display-serif | real · high |
| burgundy-editorial | solid wine | editorial | clay · high |
| navy-waves | navy + waves pattern | grotesk | real · high |
| mustard-checker | yellow + checker | bold | clay · medium |
| lilac-rounded | lilac gradient | rounded | real · medium |
| sky-gradient | sky gradient | rounded | real · medium |
| charcoal-mono | dark + plus-grid | mono | real · high |
| cream-contour | cream + contour | display-serif | real · low |
| terracotta-duotone | duotone-split | bold | real · high |
| pistachio-triangles | green + triangles | rounded | flat · medium |
| ink-neon | black, lime accent | mono | real · high |
| wine-fraunces | wine gradient | display-serif | real · high |
| paper-editorial | paper + waves | editorial | real · low |
| studio-clay | clay-orange solid | display-serif | clay · high |
| neon-grid | black + blueprint grid | condensed | real · high |
| soft-light | minimal off-white | bold | real · low |
theme.background.style. Default flat. Non-image fields render panoramically across the whole set.
| style | What it renders | Companion field |
|---|---|---|
| flat | neutral flat fill (default) | color |
| solid | single flat fill | color |
| dark | dark fill, forces light ink | color |
| minimal | near-white field with a top highlight | color |
| paper | color with a fine dotted paper texture | color |
| gradient | two-color linear gradient | gradient { from, to, angle } |
| duotone-split | two stacked color bands | duotone { top, bottom, split } |
| mesh | multi-point aurora blend | mesh { points[] } |
| image | your photo + legibility treatment | image { url, treatment, ... } |
| Field | Type / values | Default |
|---|---|---|
| background.color | hex | #f4f1ea |
| background.gradient.from | hex | background.color |
| background.gradient.to | hex | #131517 |
| background.gradient.angle | number (deg) | 180 |
| background.duotone.top | hex | #f4ead9 |
| background.duotone.bottom | hex | #c2552d |
| background.duotone.split | 0-1 | 0.44 |
| background.mesh.points[].color | hex (required) | none |
| background.mesh.points[].at | keyword or "x% y%" | center |
| background.mesh.points[].stop | 0-1 | 0.55 |
| background.mesh.points[].alpha | 0-1 | 0.8 |
| background.grain.opacity | 0-1 | 0.05 |
| background.baseColor | hex (image style) | neutral slate |
Mesh at keywords: top-left, top-center, top-right, center-left, center, center-right, bottom-left, bottom-center, bottom-right, top, bottom, left, right.
background.pattern.type overlays a tiled texture. 13 types. Companion fields: opacity (default 0.1), size px (default 40), color hex (theme-aware default).
| pattern.type | Renders |
|---|---|
| none | no pattern (default) |
| dot-grid | evenly spaced dots |
| soft-grid | thin square grid lines |
| blueprint-grid | thin grid lines (technical look) |
| large-circles | tiled ring outlines |
| radial-circles | concentric rings centered behind the device |
| diagonal-lines | repeating 45° hatch lines |
| waves | tiled sine-wave lines |
| checker | checkerboard squares |
| plus-grid | tiled plus / cross marks |
| triangles | tiled triangle outlines |
| contour | topographic concentric contour clusters |
| halftone | dot-size gradient fading from the top down |
For background.style: "image". The treatment guarantees a readable caption zone; ink derives from the treatment, never the raw photo. Default dark-scrim.
| image.treatment | Effect | Ink |
|---|---|---|
| dark-scrim | dark gradient veil over the photo | light |
| light-scrim | light gradient veil over the photo | dark |
| color-wash | desaturated photo multiplied with washColor | light |
| blur-band | clear photo, frosted blurred caption band | light |
| Field | Type / values | Default |
|---|---|---|
| [object Object] / image.b64 | image source | none |
| image.fit | cover · contain | cover |
| image.focal | [x, y] 0-1 | [0.5, 0.5] |
| image.washColor | hex (color-wash only) | background.color |
theme.headline.treatment. 9 webfont treatments. The type scale is computed once for the longest headline and locked across the set. Default bold.
| treatment | Font | Notes |
|---|---|---|
| bold | Inter heavy | default sans |
| bold-light | Inter heavy | forced light ink for saturated fields |
| serif | system serif | italic accent word |
| display-serif | Fraunces | italic accent word |
| grotesk | Space Grotesk | geometric sans |
| rounded | Nunito | friendly rounded |
| editorial | Newsreader | italic accent word |
| mono | IBM Plex Mono | technical |
| condensed | Oswald | uppercase condensed |
Also: headline.align (left · center · right, default center), and optional headline.max / headline.min px bounds on the auto-fit size.
| Field | Values | Default |
|---|---|---|
| theme.device.id | iphone-16-max · pixel-9-pro · ipad | iphone-16-max (ipad on iPad canvas) |
| device.frame.style | real · clay · flat | real |
| device.frame.tint | hex (clay/flat only) | none |
| device.shadow.elevation | none · low · medium · high | high |
| device.alignTops | boolean | true |
| device.width | 0-2 (fraction of canvas) | layout-tuned |
| device.visibleTop | 0-1 | layout-tuned |
| device.visibleBottom | 0-1 | layout-tuned |
| slide.tilt | none · left · right · subtle-left · subtle-right | none |
Note: clay and flat always use the stylized CSS iPhone body (the photoreal iphone-16-max / pixel-9-pro components cannot be tinted). Shadows are dual-layer and auto-tuned to background luminance.
One slide per output image, in store order (max 10). Standard slides composite a device + screenshot + caption.
| Field | Type / values | Notes |
|---|---|---|
| role | hook · feature · proof · close | narrative slot, affects layout emphasis (inferred if omitted) |
| headline.lines | string[] | explicit line breaks |
| headline.accent | string | word/phrase rendered in the accent color |
| subtitle | string | supporting line under the headline |
| screenshot | { url } or { b64 } | your real capture (single-device slides) |
| devices[] | SlideDevice[] | multi-device composition (see below) |
| tilt | see device table | per-slide device tilt |
| bridge | left · right | device straddles the adjacent slide for the panorama effect |
| [object Object] / deviceBottom | 0-1 | override device vertical placement |
| overlays[] | Overlay[] | proof elements (see below) |
| theme | Theme | per-slide theme override |
theme.captionPosition: top (default) or bottom places the headline block above or below the device. Landscape canvases use a side composition automatically.
Composite several framed screenshots on one canvas. Two phones → dual-phone layout; a phone plus an ipad → ecosystem layout. The last entry is the front device. Each entry:
| Field | Type / values | Notes |
|---|---|---|
| screenshot | { url } or { b64 } (required) | this device's capture |
| device | iphone-16-max · pixel-9-pro · ipad | body for this entry |
| [object Object] / frame.tint | see device table | per-device frame |
| tilt | see device table | defaults to a layout stagger |
| shadow.elevation | none/low/medium/high | per-device shadow |
| shadow.alphaScale | 0-1 | dims back-device shadows |
| x | 0-1 | horizontal center (fraction of canvas) |
| width | 0-2 | device width (fraction of canvas) |
| [object Object] / visibleBottom | 0-1 | vertical placement |
slide.overlays[]. Each needs a kind; other fields depend on the kind. Placement: position keyword (top-left … bottom-right · center) or explicit anchor / size as [x, y] canvas fractions.
| kind | Renders | Fields |
|---|---|---|
| stars | 5-star row + rating + count | rating, count |
| laurel | award laurel around a value | text, source |
| pill | trust pill with a short claim | text |
| quote-card | testimonial card | quote, author, handle, initials, variant (compact|hero) |
| press-quote | publication pull-quote | quote, source |
| review-stack | two stacked mini-reviews | reviews[] { quote, author, initials, rating } |
Set slide.type: "brand" for an icon + name/headline + tagline column with no device, typically the first (hero) or last (close) panel.
| Field | Type | Notes |
|---|---|---|
| type | "brand" | marks the slide as a brand slide |
| icon | { url } or { b64 } | app icon, clipped to an iOS squircle |
| name | string | app name (hero variant, no headline) |
| headline.lines | string[] | use instead of name for a close slide |
| tagline | string | sub-line under the name/headline |
| subtitle | string | fallback when tagline is absent |
| Field | Type / values | Notes |
|---|---|---|
| theme.accentColor | hex | accent for headline words, pills, details; WCAG auto-contrast guarded |
| output.locales | BCP-47 string[] | fan the set out across markets with explicit per-locale copy |
| output.stores | appstore · play | render the design for multiple store canvases |
| output.format | images · fastlane_zip | default images; fastlane_zip adds a deliver-ready archive |
| async | boolean | false = sync (default); true = 202 + polling_url |
| webhook_url | https url | signed callback for async renders; polling_url remains available |
For the full request/response contract, errors, idempotency, and the compliance lint report, see the API reference. The authoritative, machine-readable schema (with every enum) is openapi.json.