Skip to content
Back to glossary
Glossary term

YAML Scaffold

A human-readable YAML file that describes a screenshot render job — templates, locales, devices, variables — for use in CI.

Eric Isensee
Eric IsenseeFounder · Last updated May 5, 2026

A YAML scaffold is a declarative configuration file that describes everything a screenshot pipeline needs to render: which templates to use, which device sizes to target, which locales to render, which dynamic variables (string keys, image URLs, theme switches) to inject, and where the output should be written. YAML is the ergonomic choice because it is human-readable, supports comments, and lives naturally next to other CI assets like fastlane/Fastfile or .github/workflows. The scaffold is the bridge between the visual editor (where designers iterate on look and feel) and the API (which actually performs the render in CI). On a typical release, the developer runs a single command — `screenshotslive render --config scaffold.yml` or the equivalent Fastlane action — and the system fans out to every template × device × locale combination described in the file, uploads the resulting images, and emits a webhook when each render completes. Because the scaffold is checked into the repo, screenshot generation becomes reproducible: a release tagged six months ago can be rebuilt byte-for-byte by checking out that commit and re-running the render.

Used in

See how this concept shows up in the product:

Explore the feature