Docs / Image Scenes

Image Scenes

Image scenes display a full-bleed photo or screenshot with optional animation. Choose from default (zoom and pan), scroll for tall infographics, gallery for a smooth 3D carousel, or card for a fast spin-to-snap entrance. An optional heading renders as a bottom overlay.

Basic syntax

--- image ---                       full-bleed, default duration 6s

--- image ---                       auto-scroll tall image
variant: scroll
duration: 8s

--- image ---                       smooth 3D carousel + expand
variant: gallery
duration: 10s

--- image ---                       fast spin + sharp snap-in
variant: card
duration: 10s

![Alt text](https://example.com/screenshot.png)

Add an optional heading for a bottom gradient overlay caption:

--- image ---
duration: 6s

# Our new dashboard
![Dashboard](https://example.com/dashboard.png)

Default - zoom and pan

--- image --- object-fit: cover

The default variant fills the canvas with the image using object-fit: cover. Add zoom/pan directives to create cinematic Ken Burns-style motion - zoom into a region, hold, then ease back out.

Zoom directive syntax

--- image ---
duration: 6s

![Photo](https://example.com/photo.jpg)
00:01.0 zoom top-center 2x
00:04.0 zoom out

The zoom origin position is one of 9 named anchors:

PositionMeaning
top-leftZoom into the top-left corner
top-centerZoom into the top-center edge
top-rightZoom into the top-right corner
center-leftZoom into the left edge, vertically centered
center-centerZoom into the canvas center
center-rightZoom into the right edge, vertically centered
bottom-leftZoom into the bottom-left corner
bottom-centerZoom into the bottom edge, centered
bottom-rightZoom into the bottom-right corner

Scale and hold

Scale is optional - defaults to 2.5x. The hold Ns modifier freezes the current frame for N seconds before resuming playback:

--- image ---
duration: 8s

![Dashboard](https://example.com/dashboard.png)
00:00.5 zoom bottom-right 3x
00:02.5 zoom center-center hold 2s    hold at center for 2 seconds
00:06.0 zoom out
Tip: zoom out is shorthand for zoom center-center 1x - it resets the scale to full without jumping to a new region.

Scroll mode

--- image --- variant: scroll auto-detects direction

Scroll mode is designed for tall infographics, long screenshots, and timeline images. It auto-detects the scroll direction by comparing the image's natural aspect ratio to the canvas:

Image shapeScroll directionHow it fits
Taller than canvas proportionally top to bottom Fills canvas width exactly, scrolls down
Wider than canvas proportionally left to right Fills canvas height exactly, scrolls right

The contained dimension fills exactly with no letterboxing or cropping. Scroll travels from 0% to 100% of the overflow dimension over the full scene duration.

--- image ---
variant: scroll
duration: 10s

![Roadmap](https://example.com/roadmap-tall.png)

--- image ---
variant: scroll
duration: 8s

# Q3 Timeline
![Timeline](https://example.com/timeline-wide.png)

Card carousel

--- image --- variant: card fast spin + snap

Card mode is a high-energy alternative to gallery. The carousel starts at 0.1x scale and accelerates with motion blur as it spins, growing to fill the screen. Then a sharp 250ms crossfade drops in the first image perfectly in focus. The effect reads as "spinning fast, then locking on target."

PhaseDurationWhat happens
1 - Spin 65% of scene 3D carousel spins with accelerating speed and motion blur. Scale grows from 0.1x to 3x.
2 - Snap 250ms crossfade Blurred carousel fades out. First image snaps in sharp and full-screen.
--- image ---
variant: card
duration: 10s

![Screenshot 1](https://example.com/screen1.png)
![Screenshot 2](https://example.com/screen2.png)
![Screenshot 3](https://example.com/screen3.png)

--- image ---
variant: card
effects: rotate
duration: 10s

# The dashboard at a glance
![Dashboard](https://example.com/dashboard.png)
![Analytics](https://example.com/analytics.png)
Use card instead of gallery when you want a more aggressive, high-energy entrance. gallery is smooth and methodical; card is fast and punchy.