Opus Motion ★ Star on GitHub

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.

Story progress frames: three frames of the UI animation, start, middle and end
Story progress frames — start, middle and end of the 10.0-second motion.

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.

  • social
  • story
  • stories
  • reel
  • vertical
  • progress
  • slideshow
  • phone
  • tap
  • captions
  • swipe

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
background ink captionColor captionInk
Image props
images
Mood
editorial, ui
Roles
subject

Use Story progress frames in Remotion, React or HTML

Remotion project

terminal
# 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

tsx
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

html
<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)

json
{
  "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.

PropDefaultWhat 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)
frameCount4number of frames when no images are given
holdFrames68frames 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
showReplyBartrueshow the bottom reply bar
startAt0frame the sequence begins

Notes & credits

Technique sources:

  • original (round 3, social & marketing)