Files
hyperframes/skills/website-to-hyperframes/examples
ukimsanov 04827b98ce feat(skill): examples library scaffold + section 01 (typography) — 10 scenes
First slice of the HyperFrames Capability Showcase library at
skills/website-to-hyperframes/examples/. Each scene is a self-contained
mini-project (index.html in its own directory) that lints, snapshots, and
renders standalone.

Section 01 (typography) — 10 production-grade scenes, all PASS QC:
  01 soft-blur-in              — Apple keynote per-character reveal
  02 typewriter-mechanical     — stepped per-char terminal type-on
  03 kinetic-center-build      — words push in right-to-left, lock center
  04 line-reveal-staggered     — editorial mask-reveal-up with Fraunces italic
  05 stagger-wave              — center-out vs edges-in stagger origins
  06 variable-font-weight-shift — wght 100→900 animation via @property
  07 shared-axis-crossfade     — Material Design Z-axis depth transition
  08 glitch-rgb-split          — RGB channel offset with mechanical jitter
  09 scramble-decrypt          — per-char intermediate substitution decrypt
  10 per-word-emphasis         — per-word crossfade + hand-drawn marker

Plus catalog + shared assets:
  - examples/README.md             — top-level index + lookup by technique
  - 01-typography/README.md        — section spec + QC log per scene
  - _shared/hyper-shader-local.js  — copied from packages/shader-transitions/dist/
  - _shared/shared-styles.css      — design tokens
  - _shared/easing-glossary.md     — single source of truth for easings

Authoring conventions are documented in examples/README.md so future scenes
follow the same shape: full HTML doc, GSAP CDN, CustomEase, data-composition-id/
start/duration/width/height on root, scene-label at bottom-left, continuous
motion (no static periods >1.5s), easing variety (3+ different easings).

.gitignore: fixed bare 'examples/' rule (matched anywhere) to '/examples/'
(root-only), and added rule to skip snapshot artifacts inside the library.
2026-05-19 00:57:06 -07:00
..

HyperFrames Capability Showcase — Example Library

Purpose: Every HyperFrames technique demonstrated in one place, scene by scene. Read this when planning a video — pick the techniques you'll use, then study their scenes BEFORE writing any composition.

Why this library exists: Across 11 isolated pipeline-evaluation runs, ZERO agents used HyperFrames' powerful capabilities — they all defaulted to screenshot + Ken Burns + voiceover. Skill prose can't fix that. Worked examples can. Every scene in this library is 100% composed from divs/SVG/CSS/GSAP — no captured screenshots, no slideshow tricks.


How to use this library

When planning a beat:

  1. Open this file. Find the section that matches the technique you want.
  2. Open the section's README.md. Read 1-line summary of each scene.
  3. Open at least 2 scene HTML files. Read the full source — markup, GSAP timeline, easings, comments.
  4. Copy the closest scene into your compositions/ directory. Rename. Mutate the content. Preserve the timeline structure and event density.

When stuck on motion that feels static or boring:

  • Look at section 12-combined-vignettes/ — these are full multi-technique scenes. The chat scene (04-composed-ui/scene-02-chat-with-typing.html) is the gold standard for narration-synced events.
  • Look at section 13-anti-patterns/ — the bad examples. Make sure your scene doesn't match any of these.

The 13 sections

# Section Theme Best for beats that need…
01 01-typography/ Text animations — 24 named effects from soft-blur-in to typewriter to kinetic-center-build Headline reveals, statement beats, copy that needs personality
02 02-markers-and-emphasis/ Hand-drawn marker effects: highlight sweep, circle, burst, scribble, sketchout Emphasis words, "this matters" moments, editorial annotation
03 03-easing-variety/ The 7 production easings side-by-side; comparison grid Tuning motion intent — when power2.out everywhere feels wrong
04 04-composed-ui/ Kanban / chat / terminal / command palette / dashboard / file tree / code editor / calendar — every one built from divs Showing a product feature without using a screenshot
05 05-transitions-shader/ All 14 WebGL shader transitions (chromatic-split, sdf-iris, domain-warp, etc.) Beat-to-beat transitions with real visual weight
06 06-transitions-css/ Top 10 CSS transitions: push, scale, blur-dissolve, 3D flip, light-leak wipe, etc. Lighter transitions when shaders are overkill
07 07-html-in-canvas/ iPhone/MacBook mockups, 3D rotation+bloom, magnetic distortion, portal, shatter, liquid glass, text cursor Cinematic VFX, device showcases, "wow" moments
08 08-svg-and-path/ Logo stroke-draw, icon draw-on, MotionPath, SVG shape morph, particle-field SVG Logo reveals, illustrative moments, branded entrances
09 09-counters-and-data/ Counter 0→1M, sparklines, bar charts, pie/donut, multi-stat dashboards, arc gauges Numbers, growth claims, dashboards, "stat" beats
10 10-particles-and-ambient/ Light leak, grain, particle drift, glow pulse, camera shake, lens distortion, parallax fields Atmosphere, continuous-motion holds, mood setting
11 11-3d-and-parallax/ CSS 3D flip, perspective tilt, parallax layers, card-stack fan, three.js Depth, dimensionality, "expensive" feel
12 12-combined-vignettes/ Multi-technique scenes — 3-5 techniques running simultaneously. The real beat demos. When you want a full reference for "what a good beat looks like"
13 13-anti-patterns/ Annotated BAD examples — slideshow trap, static-after-entrance, power2-everywhere, screenshot-Ken-Burns Knowing what to avoid

Lookup by technique

Need a specific technique? Use this table to find the canonical scene.

Technique Canonical scene
Headline blur entrance 01-typography/scene-01-soft-blur-in.html
Terminal-style typewriter 01-typography/scene-02-typewriter-mechanical.html
Per-word kinetic build 01-typography/scene-03-kinetic-center-build.html
Highlight bar sweep 02-markers-and-emphasis/scene-01-highlight-sweep.html
Hand-drawn circle around word 02-markers-and-emphasis/scene-02-hand-drawn-circle.html
7-easing side-by-side comparison 03-easing-variety/scene-08-all-easings-grid.html
Animated kanban with drag 04-composed-ui/scene-01-kanban-board.html
Chat with typing dots + reaction 04-composed-ui/scene-02-chat-with-typing.html
Terminal with type-on text 04-composed-ui/scene-03-terminal-typeon.html
Command palette filtering 04-composed-ui/scene-04-command-palette.html
Dashboard with counters + sparklines 04-composed-ui/scene-05-dashboard-counters.html
WebGL shader transition between beats 05-transitions-shader/scene-NN-<name>.html (14 options)
CSS push/scale/blur transitions 06-transitions-css/scene-NN-<name>.html (10 options)
iPhone mockup with live screen 07-html-in-canvas/scene-01-iphone-mockup.html
MacBook mockup with live screen 07-html-in-canvas/scene-02-macbook-mockup.html
3D rotation + bloom VFX 07-html-in-canvas/scene-03-3d-rotation-bloom.html
Logo stroke-draw entrance 08-svg-and-path/scene-01-logo-stroke-draw.html
MotionPath orbit/follow 08-svg-and-path/scene-03-motion-path.html
Counter 0→1M with comma format 09-counters-and-data/scene-01-counter-to-million.html
Sparkline draw-on 09-counters-and-data/scene-02-sparkline-draw.html
Light leak overlay 10-particles-and-ambient/scene-01-light-leak.html
Ambient particle drift 10-particles-and-ambient/scene-03-particle-drift.html
Camera shake on impact 10-particles-and-ambient/scene-05-camera-shake.html
CSS 3D flip card 11-3d-and-parallax/scene-01-3d-flip-card.html
Parallax depth layers 11-3d-and-parallax/scene-03-parallax-layers.html
Three.js rotating geometry 11-3d-and-parallax/scene-05-three-js-geometry.html

Shared assets

  • _shared/hyper-shader-local.js — local shader build (copied from packages/shader-transitions/dist/index.global.js). Scenes in 05-transitions-shader/ and 12-combined-vignettes/ import this.
  • _shared/shared-styles.css — design tokens (color palette, type scale, spacing). Every scene <link>s this so the catalog feels cohesive.
  • _shared/easing-glossary.md — the 7 production easings and when to use each. Single source of truth.

Stitched reels

The _stitched/ directory contains 2-3 long videos that play many scenes in sequence — useful for visual-gestalt review:

Rendered MP4s live in _stitched/renders/ and are mirrored on HeyGen Verse for browser viewing.


Authoring conventions (read before adding a scene)

Every scene in this library follows these rules. They exist so agents reading the library see consistent patterns, not random codebases.

  1. Single HTML file, structure exactly:

    <template>
      <style>/* scoped to this scene */</style>
      <link rel="stylesheet" href="../_shared/shared-styles.css">
      <div id="<scene-id>"
           data-composition-id="<scene-id>"
           data-width="1920"
           data-height="1080"
           class="scene"
           style="background: var(--bg-deep);">
        <!-- scene markup -->
        <div class="scene-label">
          Section <NN> · <Scene name> · <Technique>
        </div>
      </div>
      <script>
        (function () {
          var BEAT = <duration-in-seconds>;
          window.__timelines = window.__timelines || {};
          var tl = gsap.timeline({ paused: true });
          // ... build timeline
          window.__timelines["<scene-id>"] = tl;
        })();
      </script>
    </template>
    
  2. data-composition-id matches the filename (without .html). e.g. file scene-01-soft-blur-in.html → id scene-01-soft-blur-in.

  3. .scene-label at bottom-left of every scene shows what technique is being demonstrated. Lets viewers of the stitched reel know what they're looking at without playing detective.

  4. tl.fromTo() not tl.from() for entrances. Avoids the "CSS opacity:0 + gsap.from(opacity:0)" 0→0 trap.

  5. Continuous motion — no element stays unchanged for more than ~1.5s. If a beat is 8s, schedule 5-8 events spread across the duration, not 5 events crammed into the first second.

  6. Easing variety — minimum 3 different easings per scene. See _shared/easing-glossary.md.

  7. Determinism — no Math.random(), Date.now(), requestAnimationFrame, or repeat: -1. Seed any "random" particles via a fixed array of values.

  8. Lint clean — every scene must pass npx hyperframes lint . with 0 errors before being committed.

  9. Snapshot verified — every scene's 5-frame snapshot must show CHANGE between frames (not entrance + 4 identical hold frames).

  10. Comments — one comment per timeline section explaining WHY that timing was picked. Not WHAT it does (the code shows that). e.g. // 1.2s: settle with elastic — gives the counter time to "land" before the next stat enters.