How to use Claude Code and Hyperframes to generate polished MP4 animations — no Figma, no After Effects, no paid software. Includes the master prompt and 32 starter templates.
This guide is reviewed for clarity, service accuracy, and AI-search readability. The next quarterly content review is tracked internally before unsupported metrics or client proof are added.
Build 90+ Animations With Claude Code and Hyperframes — No Design Tools Required
You don't need Figma. You don't need After Effects. You don't need a design background.
Hyperframes is a free, open-source engine that renders HTML into MP4 video — frame by frame, pixel-perfect, fully deterministic. Claude Code writes the HTML. Hyperframes renders the video. You get a polished animation in minutes.
This guide gives you everything: the master prompt, 32 starter templates, the install workflow, and the fixes for when things break.
How Hyperframes Renders HTML to MP4
This is the mechanism in plain terms — understanding it helps you prompt Claude more effectively.
Hyperframes opens your HTML file in a headless Chromium browser. It doesn't record the screen in real time. Instead, it seeks to each frame's exact timestamp, takes a screenshot, then moves to the next frame. Once it has captured every frame, it hands them to ffmpeg, which encodes the sequence into a standard MP4.
This is what "deterministic rendering" means: the same HTML always produces the exact same video. There's no runtime variation, no dropped frames from CPU load. Your animation is timed by code, not by wall-clock execution.
Animations can be driven by CSS transitions, GSAP, Lottie, Three.js, GLSL shaders, or any JavaScript that runs in a browser. Hyperframes doesn't care which — if the browser can run it, Hyperframes can render it.
Install and Run Workflow
Step 1 — Prerequisites
You need Node.js (v18+) and npm installed. To verify:
bashnode --version npm --version
Run the dependency check after install:
bashnpx hyperframes doctor
This catches missing ffmpeg or browser binaries before you try to render.
Step 2 — Install the CLI
bashnpm install -g hyperframes
Or use npx for one-off commands without a global install:
bashnpx hyperframes <command>
Step 3 — Create a New Project
bashhyperframes init my-animation cd my-animation
This scaffolds a starter project from an example template with an index.html and a config file.
Step 4 — Drop In Your HTML
Replace the contents of index.html with the HTML Claude Code generates (see the master prompt below). The file path is relative to your project root.
Step 5 — Preview Live
bashhyperframes preview
Opens a browser with hot reload. Every time you save the HTML, the preview updates. Use this to dial in timing before committing to a render.
Step 6 — Render to MP4
bashhyperframes render
Outputs output.mp4 in your project directory by default. For a custom output path:
bashhyperframes render --output ./exports/my-animation.mp4
For a specific resolution (default is 1920×1080):
bashhyperframes render --width 1080 --height 1920
Step 7 — Inspect and Lint
Before publishing, check for overflow or structural issues:
bashhyperframes inspect hyperframes lint
inspect flags text that's clipped or containers that overflow the viewport. lint checks for structural errors in the HTML schema.
The Master Claude Code Prompt
Paste this into Claude Code. Replace the bracketed sections with your animation description.
promptYou are generating a Hyperframes-compatible HTML animation. Hyperframes renders HTML to MP4 by opening it in a headless browser, seeking to each frame timestamp, capturing a screenshot, and encoding the frames with ffmpeg. Your output is a single self-contained HTML file. Follow these rules exactly: TECHNICAL REQUIREMENTS: - All styles must be inline in a <style> tag in the <head>. No external CSS files. - All JavaScript must be inline in a <script> tag before </body>. No external JS files. - Animations must start at t=0 (page load). Do not wait for user interaction. - Use CSS animations or GSAP (loaded from CDN) for motion. Do not use setTimeout as the primary timing mechanism. - The viewport is [WIDTH]×[HEIGHT]px. Set body { margin: 0; overflow: hidden; width: [WIDTH]px; height: [HEIGHT]px; }. - Total duration: [DURATION] seconds. All animations must complete within this window. - Use data-hf-duration="[DURATION]" on the <body> element to declare total length. ANIMATION DESCRIPTION: [DESCRIBE YOUR ANIMATION HERE — what appears, in what order, with what motion style] COLOR PALETTE: - Primary: [HEX] - Accent: [HEX] - Background: [HEX] - Text: [HEX] ANIMATION STYLE: [Choose: smooth/snappy/elastic/cinematic/data-driven] OUTPUT: Return only the complete HTML file. No explanation. No markdown wrapper. Just the raw HTML starting with <!DOCTYPE html>.
Quick-Start Version (Minimum Viable Prompt)
For fast iteration, use this stripped-down version:
promptGenerate a self-contained Hyperframes HTML animation file. Rules: all CSS/JS inline, animations start at t=0, no external dependencies except GSAP from CDN if needed, viewport 1920×1080, duration 8 seconds, add data-hf-duration="8" to <body>. Animation: [YOUR DESCRIPTION] Colors: background [HEX], primary text [HEX], accent [HEX]. Return only the raw HTML file. No explanation.
32-Template Starter Pack
These are ready-to-use animation descriptions. Paste the bracketed description directly into the master prompt above.
Social UI (8 Templates)
| # | Name | Description | Use Case |
|---|---|---|---|
| 1 | App Onboarding Swipe | Three screens slide in from the right sequentially, each revealing a feature headline and icon | SaaS product demos, app store previews |
| 2 | Notification Stack | Toast notifications drop in from top-right one by one, each with an icon, title, and body text | Marketing explainers, product launch announcements |
| 3 | Mobile Chat Reveal | Chat bubbles appear alternately left and right with a typing indicator, simulating a conversation | DM automation demos, customer support showcases |
| 4 | Dashboard Unlock | A dark analytics dashboard fades in, then KPI cards animate up with counter increments | Agency case studies, SaaS metrics storytelling |
| 5 | Story Tap Progress | Full-screen gradient with a progress bar ticking across the top, text content swapping at each segment | Instagram story recreations, course previews |
| 6 | Profile Card Flip | A card rotates 180° to reveal detailed stats on the back, with a shimmer effect on entry | LinkedIn posts, personal branding |
| 7 | Feed Scroll Loop | A social feed scrolls upward continuously, each card fading in as it enters the viewport | Platform demos, content strategy posts |
| 8 | App Icon Bounce Grid | A 3×3 grid of rounded app icons bounces in with staggered spring physics | App launch announcements, portfolio showcases |
Data Visualization (8 Templates)
| # | Name | Description | Use Case |
|---|---|---|---|
| 9 | Bar Chart Race | Horizontal bars grow from left to right in ranked order, labels counting up alongside | Market share comparisons, before/after metrics |
| 10 | Line Chart Draw | A line traces itself across the x-axis from left to right with a glowing leading point | Revenue growth, trend storytelling |
| 11 | Donut Chart Fill | A donut chart segment fills clockwise from 0% to the target value, with a percentage counter in the center | Goal progress, survey results |
| 12 | Stat Counter Burst | Large numbers count up from zero with a starburst particle effect when they hit the final value | Social proof, milestone announcements |
| 13 | Waffle Grid Progress | A grid of squares fills in one by one, left to right, to represent a percentage | Survey data, completion rates |
| 14 | Heatmap Pulse | A calendar-style heatmap where cells light up in sequence from low to high intensity | GitHub activity, engagement calendars |
| 15 | Funnel Drop | A sales funnel animates from top to bottom, each stage dropping into place with its label and conversion rate | Sales decks, pipeline explainers |
| 16 | Comparison Slider | Two columns animate in side by side — left shrinks while right grows — with labels and values | Before/after comparisons, A/B test results |
Text Effects (8 Templates)
| # | Name | Description | Use Case |
|---|---|---|---|
| 17 | Word Cascade | Words drop in one by one from above, settling into a headline with a subtle bounce | Hook slides, quote cards |
| 18 | Typewriter Loop | Text types character by character, pauses, then deletes and retypes a second phrase | Value propositions, rotating taglines |
| 19 | Scramble Reveal | Characters randomize rapidly then snap to the final word, letter by letter | Tech-flavored reveals, product names |
| 20 | Gradient Sweep | Static headline text has a moving gradient shimmer sweep across it from left to right | Premium brand moments, course titles |
| 21 | Split Reveal | A headline splits at the center, each half sliding outward to reveal a subheadline underneath | Chapter transitions, section openers |
| 22 | Blur-to-Sharp | Text starts blurred and sharpens into focus over 1.5 seconds | Cinematic intros, quote reveals |
| 23 | Stacked Lines Build | Three lines of copy slide in from the left in sequence, each slightly delayed | Listicle intros, three-point frameworks |
| 24 | Neon Flicker | Text glows with a neon effect and flickers once on entry before settling to steady | Dark-mode content, tech/gaming brands |
3D and Cinematic (8 Templates)
| # | Name | Description | Use Case |
|---|---|---|---|
| 25 | Depth Parallax Scroll | Layers at different depths scroll at different speeds to simulate 3D depth | Hero sections, landscape scenes |
| 26 | Cube Rotate | A 3D CSS cube rotates slowly to reveal a different face, each face showing a different piece of content | Product feature reveals, four-pillar frameworks |
| 27 | Camera Push-In | A background image scales up slowly while text fades in, simulating a camera push | Cinematic openers, documentary-style content |
| 28 | Particle Disperse | Text or a logo explodes into particles and reassembles | Brand intros, impactful transitions |
| 29 | Sky Atmosphere | A gradient sky shifts from dawn to dusk colors across the clip duration | Ambient backgrounds, time-lapse storytelling |
| 30 | Map Pin Drop | A stylized map outline fades in, then pins drop one at a time with ripple effects | Location-based businesses, geographic reach |
| 31 | Film Burn Transition | An orange/amber burn effect wipes across the frame, revealing a new scene | Chapter transitions, storytelling pivots |
| 32 | Floating Orbs Loop | Soft-glow spheres drift slowly in 3D space, with subtle depth-of-field blur | Background motion for titles, ambient intros |
The Full 90+ Template Library: Category Breakdown
Hyperframes ships with a broad catalog. Here's how the full library is organized and what you can do with each category:
Social UI and App Interactions
Recreations of real mobile and web UI patterns — feed cards, modals, notifications, onboarding flows. Use for product marketing, SaaS demos, or showing how your tool works without recording a screen.
Data Visualization
Animated charts and stats: bar races, line draws, counters, heatmaps, funnels. All data-driven — you swap the numbers in the HTML and the animation updates automatically. Use for results posts, case studies, and before/after comparisons.
Text Effects
Headline reveals, typewriter loops, word cascades, split reveals. Text-forward animations built for social content where the message is the product. Layer these over brand colors for high-impact quote cards or framework slides.
Gamification Mechanics
Progress bars, XP counters, achievement unlocks, leaderboards. Use for course content, habit app demos, or any post about streaks and momentum.
Dev-Flavored Animations
Code syntax highlights, terminal typing sequences, version bump animations, git branch diagrams. Natively appealing to developer audiences — no explanation needed, the format signals the context.
3D Scenes and Depth Effects
CSS 3D transforms, Three.js scenes, parallax depth layers, perspective tunnels. No WebGL setup required — Hyperframes handles rendering. Use for premium brand moments and cinematic openers.
Geographic and Map Animations
Map outline reveals, pin drops, route traces, choropleth fills. Built for location-based businesses, travel content, and "we operate in X markets" announcements.
Cinematic Transitions and Atmospheric Effects
Film burns, lens flares, sky time-lapses, fog overlays, bokeh backgrounds. These are ambient — use them as backgrounds for text or as transitions between sections in a longer video.
Prompting Claude Code to Customize Templates
Once you have a base animation, these prompt patterns get you to a finished result faster.
Change Colors
promptUpdate the animation to use this brand palette: - Background: #0F0F0F - Primary text: #FFFFFF - Accent / highlight: #7B5CF6 - Secondary text: #A1A1AA Replace every hardcoded color in the CSS. Keep all animation timing and structure unchanged.
Adjust Timing
promptThe animation currently runs 8 seconds. Adjust it to 6 seconds by scaling all animation durations and delays proportionally. Update data-hf-duration to "6". Do not change the sequence order.
Swap Copy
promptReplace all placeholder text in the HTML with the following content. Keep all CSS class names, animation attributes, and structure identical — only change the text node values. Headline: [YOUR HEADLINE] Subheadline: [YOUR SUBHEADLINE] Body: [YOUR BODY COPY]
Add a Data Series
promptThe current bar chart shows three bars. Add two more bars with these values and labels: - Label: "Q4 2025", Value: 84 - Label: "Q1 2026", Value: 91 Match the existing bar style, color, and animation timing. Each new bar should enter in sequence after the previous one, with the same 0.3s stagger.
Change Animation Style
promptThe current animation uses linear easing throughout. Rewrite all transitions and keyframe animations to use ease-out-back easing for a snappier, more physical feel. Keep all durations the same.
Add a Logo or Icon
promptAdd a logo mark to the bottom-left corner of the composition. Use a circular container, 48×48px, background color #7B5CF6, with the letter "H" in white, 20px, font-weight 700. It should fade in at t=0.2s with a 0.4s opacity transition. Position: absolute, bottom: 24px, left: 24px.
Common Failure Modes and Fixes
Blank or Black Video Output
Cause: Animations haven't started by the time Hyperframes captures the first frame, or there's a JavaScript error preventing execution.
Fix: Check the browser console using hyperframes preview. Look for JS errors. Make sure all animations trigger at t=0 (on DOMContentLoaded or via CSS animation-play-state: running without a trigger). Remove any setTimeout delays at the start of your animation sequence.
Animations Freeze or Stop Early
Cause: data-hf-duration on the <body> is shorter than the actual animation runtime, so Hyperframes stops capturing before the animation finishes.
Fix: Increase the data-hf-duration value to match or exceed your longest animation end time. Check your CSS animation-duration + animation-delay values to calculate the true end time.
Fonts Not Rendering
Cause: Google Fonts or external font files fail to load in the headless browser environment, falling back to a system font that changes the layout.
Fix: Use @font-face with a base64-encoded font inline in your <style> block, or switch to system fonts (system-ui, -apple-system, 'Helvetica Neue'). For Google Fonts, embed the font CSS inline using the @import URL at the top of your style block and verify it resolves.
Prompt fix:
promptRewrite the font declarations to use only system fonts: font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif. Remove all Google Fonts imports.
Content Clipped at Viewport Edge
Cause: Elements are positioned or animated outside the WIDTH×HEIGHT viewport boundary. Hyperframes crops to the exact viewport.
Fix: Run hyperframes inspect — it reports overflowing elements with their coordinates. Then prompt Claude:
promptThe following elements overflow the 1920×1080 viewport boundary. Constrain them so all content stays within the viewport at all animation states. Do not change the animation style, only adjust positioning and sizing. Overflowing elements: [paste inspect output here]
GSAP Animations Not Playing
Cause: GSAP loaded from CDN fails in the headless environment, or the GSAP script tag is placed after the animation code that calls it.
Fix: Move the GSAP CDN <script> tag to the <head> or before any script that references gsap. If CDN is unreliable, prompt Claude to rewrite the animation using pure CSS keyframes instead.
Render Takes Too Long or Hangs
Cause: Heavy Three.js scenes or shader-based animations are compute-intensive at full resolution.
Fix: First try hyperframes render --width 1280 --height 720 to render at 720p. If it completes, the issue is GPU/memory pressure at 1080p. For production, use cloud rendering on AWS Lambda or Google Cloud Run (both are supported by the Hyperframes package ecosystem) to offload the workload.
hyperframes doctor Reports Missing ffmpeg
Cause: ffmpeg is not installed or not on your PATH.
Fix:
bash# macOS brew install ffmpeg # Verify ffmpeg -version
Then re-run hyperframes doctor to confirm it's resolved.
FAQ
Q: Do I need to know how to code to use Hyperframes with Claude Code?
No. Claude Code generates the HTML file — you paste the prompt, copy the output, and drop it into your Hyperframes project. The only commands you run are the CLI ones above. You don't write or edit any code unless you want to.
Q: Can I use Hyperframes animations in Instagram Reels or TikToks?
Yes. Render with --width 1080 --height 1920 for a vertical 9:16 aspect ratio. The output is a standard MP4 you can upload directly to any platform. Adjust your Claude Code prompt to match the dimensions before generating the HTML.
Q: Is Hyperframes actually free, or does the cloud rendering cost money?
The CLI and local rendering are fully free and open-source. Cloud rendering via AWS Lambda or Google Cloud Run uses your own cloud account and incurs standard compute costs — but for short clips rendered occasionally, it's a few cents per render. For local use, there's no cost at all.
This workflow — Claude Code for the HTML, Hyperframes for the render — is one of the fastest paths from an animation idea to a finished MP4. No subscriptions, no timelines, no design tools. At Hypd, it's part of how we build content automation pipelines for founders who want to ship faster.
Start with one template from the starter pack, run through the workflow once end to end, and you'll have a working animation in under 30 minutes.