tvos-assets

What Goes In

Three Ways To Run

Every Run Ships a Contact Sheet

Below is the tvOS and iOS catalog that tvos-assets@1.7.0 wrote from Tomo TV's brand resources, at true pixel dimensions. The same run writes preview.html with embedded images, colorset swatches, both parallax imagestacks, and the App Store images and four video loops.

tvOS

App Icon - Home Screen6 files

front@1x.png

400 × 240

front@2x.png

800 × 480

middle@1x.png

400 × 240

middle@2x.png

800 × 480

back@1x.png

400 × 240

back@2x.png

800 × 480

App Icon - App Store3 files

front@1x.png

1280 × 768

middle@1x.png

1280 × 768

back.png

1280 × 768

Top Shelf4 files

Standard and wide, composited from the same two inputs at 1x and 2x.

top@1x.png

1920 × 720

top@2x.png

3840 × 1440

wide@1x.png

2320 × 720

wide@2x.png

4640 × 1440

iOS

App Icon - Light / Dark / Tinted (iOS 18+)3 files

One appiconset, three appearances. Dark sits on transparency so iOS supplies the gradient; tinted ships as grayscale for the user's accent color. Both are derived from your icon, or overridden with --icon-dark and --icon-tinted.

icon-1024.png

1024 × 1024

icon-1024-dark.png

1024 × 1024

icon-1024-tinted.png

1024 × 1024

Shared

Splash Screen Logo5 files

200-icon@1x.png

200 × 200

200-icon@2x.png

400 × 400

200-icon@3x.png

600 × 600

200-icon-tv@1x.png

200 × 200

200-icon-tv@2x.png

400 × 400

Standalone1 file

icon.png

1024 × 1024

See generated preview.html

App Store Creative Assets

New in 1.6.0: --app-store also writes the iOS 27 and iPadOS 27 creative assets into AppStore/, beside Images.xcassets. Every placement App Store Connect takes is covered, each as an opaque PNG with the art inside the safe areas from Apple's creative asset templates, and the ones that take video get a seamless loop.

Below is what the published 1.7.0 package wrote for TomoTV's own listing: one SVG of row artwork for the header, search results and universal images, another for a Live TV In-App Event, every video a 20 s loop with music. Header and search cards rise and sink; the event cards slide in rows. These are web copies, so tap a video for sound; the originals are full-size H.264 High.

These files are in use: Tomo TV's App Store listing runs them, so the header and search results there are this tool's output.

Row artwork

Row artwork is an SVG whose <mask>holds rows of one repeated card over full-canvas fills, the wall of cards a Figma or Sketch export gives you, with anything fixed drawn on top. One file serves every placement: it is re-tiled to each canvas and centred on that placement's art safe area. Add animate: { rows: 20 } and the rows slide one card per loop, alternating direction, while the fixed layer stays put, so the last frame runs into the first. A shape drawn on top of one card rides its row, like the live dot above. Every rule is checked, and a file that breaks one fails with a message naming it.

Scene artwork

New in 1.10.0. A scene is any other SVG, a night sky or a wordmark on a gradient, cover-fitted to each canvas. animate: { loop: 20, elements: [...] } makes its video: each rule selects elements of the file (#id, tag or #id tag) and writes an <animate>on every one of them in SMIL's own words, attributeName, values, dur, additive and the rest, with staggerspreading the starts so no two neighbours move in step. The frames come from the Google Chrome on your machine, the file's animations paused and seeked to each frame's time, so the video is what Safari and Chrome play when they open the SVG. The file as played is written beside the still, so the loop can be previewed in a browser before it renders. An SVG that already carries its own <animate> tags needs no rules at all.

A fast renderer

Only the cards move, so each frame is blended from the artwork drawn once with every card lit and once with none, through a card mask built from row strips, several frames at a time. A 20 s 4K header loop takes about 30 s on an M1 Max. Art the blend cannot reproduce exactly is drawn in full each frame instead. Videos encode as H.264 High on libx264, whose quality holds steady across keyframes so the loop point does not hitch, or as ProRes 422 HQ. A simulator recording works too: header.video or searchResults.video is cut into the same kind of seamless loop.

Looped music

video.audioputs music on every video instead of the silent track, looped so it never cuts: each video takes a stretch of the track one second longer than itself and crossfades that last second into its first. The stretch sits where the beat a loop length later lines up with the beat at its start, and the level never drops below half the music's median.

From the Expo plugin

Give the plugin an appStore prop and every expo prebuild writes the creative assets into its outDir (default ./AppStore), outside ios/ so prebuild never wipes them. Unchanged files are skipped, so the videos only render again after their artwork or settings change.

One Config, Three Surfaces

When the same setting arrives from two places, the more direct one wins: the config file overrides the defaults, --set overrides the config file, and --icon, --background, and --color always win.

CLI Reference

Inputs

Output

App Store

Naming & selection

Advanced

Questions