UI · story-progress-frames
Story progress frames
A vertical story player in a rounded 9:16 frame: segmented progress bars fill one by one, a handle header, tap-through between frames with a tap ripple and a slide, and a caption pill per frame. Uses your images or procedural scenes.
A free, MIT-licensed UI animation from the Opus Motion Library — 616 motions for Remotion, React and plain HTML.

What Story progress frames is for
Story / reel mockups, "swipe through" product tours, social recaps, vertical slideshow promos and app-store style feature walk-throughs.
Details
- Category
- UI & product mockup animations
- Length
- 10.0 s (300 frames at 30 fps)
- Formats
- 16:9, 1:1, 9:16
- Weight
- light
- Transparent overlay
- yes
- Seamless loop
- no
- Text props
- —
- Colour props
backgroundinkcaptionColorcaptionInk- Image props
images- Mood
- editorial, ui
- Roles
- subject
Use Story progress frames in Remotion, React or HTML
Remotion project
# copy this motion into your Remotion project
node cli/mgl.mjs add story-progress-frames --to ../my-app/src
# render an mp4 (run in the library folder)
node cli/mgl.mjs render story-progress-frames --props '{"background":"#101018","ink":"#ffffff","captionColor":"#ffffff","captionInk":"#14141C","images":[]}'
# or export for apps / editors: mp4 | webm-alpha | prores-alpha | gif | png | poster
node cli/mgl.mjs export story-progress-frames --as webm-alpha --props '{"background":"#101018","ink":"#ffffff","captionColor":"#ffffff","captionInk":"#14141C","images":[]}'React / Next.js
import {MotionPlayer} from 'opus-motion-library/web';
<MotionPlayer
motion="story-progress-frames"
props={{
background: '#101018',
ink: '#ffffff',
captionColor: '#ffffff',
captionInk: '#14141C',
images: [],
}}
playOnView
loop="auto"
/>Plain HTML / WordPress
<script src="opus-motion.element.js" defer></script>
<opus-motion motion="story-progress-frames"
props='{"background":"#101018","ink":"#ffffff","captionColor":"#ffffff","captionInk":"#14141C","images":[]}'>
</opus-motion>Compose spec (multi-scene video)
{
"width": 1920,
"height": 1080,
"fps": 30,
"scenes": [
{
"motion": "story-progress-frames",
"props": {
"background": "#101018",
"ink": "#ffffff",
"captionColor": "#ffffff",
"captionInk": "#14141C",
"images": []
}
}
]
}Story progress frames props
14 parameters — change any of them to make the motion yours.
| Prop | Default | What it does |
|---|---|---|
images | [] | public/ image paths, one per frame (empty = procedural scenes; then frameCount applies) |
captions | ["Chapter one: the idea","Chapter two: the build","Chapter three: the launch","Thanks f… | one caption pill per frame (cycles) |
frameCount | 4 | number of frames when no images are given |
holdFrames | 68 | frames each story frame is shown (the progress bar fills over this) |
handle | "@yourhandle" | account handle in the header (drives the avatar initials) |
timeAgo | "2h" | small age label next to the handle |
replyLabel | "Send a message" | text in the reply bar |
background | "#101018" | frame colour behind the phone, or "transparent" |
ink | "#ffffff" | outline tone around the phone |
accent | "auto" | progress fill colour or "auto" (white) |
captionColor | "#ffffff" | caption pill fill |
captionInk | "#14141C" | caption text colour |
showReplyBar | true | show the bottom reply bar |
startAt | 0 | frame the sequence begins |
Related motions

Lesson carousel
Course / playlist / step navigation in app promos; a chapter selector at the bottom of an explainer.
lesson-carousel
Lesson player toolbar
Making a narrated explainer, tutorial or product walkthrough feel like a real interactive player; an on-screen caption bar with step…
player-toolbar
Talking head PiP
Course videos, creator explainers, product walkthroughs with a host; pair with caption-style motions for subtitles.
talking-head-pip
Carousel 3D
Portfolio reels, product galleries, template showcases, "pick from the collection" beats.
carousel-3d
Comment bubble stream
Social proof, "what people are saying", reaction / reply montages, community and live-chat moments, comment-section explainers and ad…
comment-bubble-stream
Device mockup (phone, tablet, laptop, watch)
App launches, feature tours, testimonials, store previews: makes a host screenshot look shipped. Pass `src` (and `src2` for the flip side)…
device-mockup
Notes & credits
Technique sources:
- original (round 3, social & marketing)