hyperframes-motion
All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). HyperFrames-native: single paused timeline, seek-safe, deterministic.
- License 许可
- MIT
- 最近更新
- 2026-10-08
- Stars
- ★ 11
- Forks
- 3
01 前言 Front Matter
- name
- hyperframes-motion
- description
- All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). HyperFrames-native: single paused timeline, seek-safe, deterministic.
02 资源文件 73
- 参考文档adapters/animate-text.md4.0 KB
- 参考文档adapters/animejs.md3.2 KB
- 参考文档adapters/css-animations.md3.8 KB
- 参考文档adapters/gsap-easing-and-stagger.md6.1 KB
- 参考文档adapters/gsap-timeline-and-labels.md3.6 KB
- 参考文档adapters/gsap-transforms-and-perf.md3.4 KB
- 参考文档adapters/gsap.md6.7 KB
- 参考文档adapters/html-in-canvas-patterns.md16.8 KB
- 参考文档adapters/lottie.md3.3 KB
- 参考文档adapters/three.md4.3 KB
- 参考文档adapters/typegpu.md7.3 KB
- 参考文档adapters/waapi.md3.2 KB
- 参考文档blueprints-index.md12.4 KB
- 参考文档blueprints/brand-reveal-assemble-zoom.md14.7 KB
- 参考文档blueprints/comparison-split-cards.md14.8 KB
- 参考文档blueprints/concept-demo-decode-pan.md16.7 KB
- 参考文档blueprints/cta-morph-press.md16.1 KB
- 参考文档blueprints/cta-orbit-collapse.md17.8 KB
- 参考文档blueprints/demo-page-scroll-spotlight.md16.5 KB
- 参考文档blueprints/hook-counter-burst.md14.8 KB
- 参考文档blueprints/messaging-multi-phrase.md14.7 KB
- 参考文档blueprints/metric-video-text-pivot.md19.0 KB
- 参考文档blueprints/problem-mockup-overwhelm.md16.7 KB
- 参考文档blueprints/proof-logo-chain.md17.2 KB
- 参考文档blueprints/takeover-ticker-displace.md14.8 KB
- 参考文档blueprints/workflow-approve-press.md16.3 KB
- 参考文档rules-index.md10.7 KB
- 参考文档rules/3d-page-scroll.md8.7 KB
- 参考文档rules/3d-text-depth-layers.md11.4 KB
- 参考文档rules/ai-tracking-box.md14.7 KB
- 参考文档rules/avatar-cloud-network.md13.7 KB
- 参考文档rules/camera-cursor-tracking.md12.3 KB
- 参考文档rules/card-morph-anchor.md12.0 KB
- 参考文档rules/center-outward-expansion.md7.9 KB
- 参考文档rules/context-sensitive-cursor.md10.7 KB
- 参考文档rules/coordinate-target-zoom.md14.7 KB
- 参考文档rules/counting-dynamic-scale.md9.1 KB
- 参考文档rules/css-marker-patterns.md8.1 KB
- 参考文档rules/cursor-click-ripple.md10.8 KB
- 参考文档rules/discrete-text-sequence.md9.9 KB
- 参考文档rules/dynamic-content-sequencing.md11.7 KB
- 参考文档rules/gsap-effects.md5.2 KB
- 参考文档rules/hacker-flip-3d.md9.7 KB
- 参考文档rules/multi-phase-camera.md10.3 KB
- 参考文档rules/orbit-3d-entry.md12.6 KB
- 参考文档rules/physics-press-reaction.md12.3 KB
- 参考文档rules/press-release-spring.md12.0 KB
- 参考文档rules/reactive-displacement.md11.0 KB
- 参考文档rules/scale-swap-transition.md10.5 KB
- 参考文档rules/sine-wave-loop.md12.1 KB
- 参考文档rules/split-tilt-cards.md11.0 KB
- 参考文档rules/stat-bars-and-fills.md5.5 KB
- 参考文档rules/svg-icon-enrichment.md12.0 KB
- 参考文档rules/svg-path-draw.md9.7 KB
- 参考文档rules/vertical-spring-ticker.md10.2 KB
- 参考文档rules/viewport-change.md14.0 KB
- 参考文档techniques.md13.7 KB
- 参考文档transitions/catalog.md6.5 KB
- 参考文档transitions/css-3d.md421 B
- 参考文档transitions/css-blur.md1.7 KB
- 参考文档transitions/css-cover.md1.4 KB
- 参考文档transitions/css-destruction.md4.4 KB
- 参考文档transitions/css-dissolve.md2.4 KB
- 参考文档transitions/css-distortion.md1.8 KB
- 参考文档transitions/css-grid.md370 B
- 参考文档transitions/css-light.md2.3 KB
- 参考文档transitions/css-mechanical.md1.6 KB
- 参考文档transitions/css-other.md838 B
- 参考文档transitions/css-push.md1.2 KB
- 参考文档transitions/css-radial.md1.0 KB
- 参考文档transitions/css-scale.md715 B
- 参考文档transitions/overview.md13.5 KB
- 参考文档transitions/TRANSITION-REGISTRY.md7.8 KB
03 SKILL.md 正文
HyperFrames Motion
All motion knowledge in one skill: rules (atomic recipes), blueprints (multi-phase scene templates), transitions (scene-to-scene), techniques (broader motion-design patterns), and adapters (per-runtime APIs).
For the composition contract (data attributes, sub-compositions, determinism) see /hyperframes → core/.
Default: compose atomic rules
Pick 2-4 rules from rules-index.md, glue them together with a single paused GSAP timeline, done. This is faster and produces less code than starting from a blueprint.
Load a blueprint when
- The scene matches an existing pre-designed multi-phase template (brand-reveal, social-proof, demo-page-scroll-spotlight, etc.) and reusing its phase pipeline saves real authoring time
- You want runnable ground-truth code for a complex 4-5 phase choreography
Blueprints live in blueprints-index.md. Each entry points to blueprints/<id>.md (recipe) and examples/<id>.html (runnable sample). Do not read it speculatively; load it when you've already decided you need scene-level orchestration.
Routing
| Want to… | Read |
|---|---|
| Pick an atomic motion pattern by trigger / tag | rules-index.md |
| Read one rule's full HTML / CSS / GSAP recipe | rules/<name>.md |
| Pick a multi-phase scene template | blueprints-index.md |
| Read one blueprint's full recipe | blueprints/<id>.md + examples/<id>.html |
| Author a scene transition (CSS-driven, between two clips) | transitions/overview.md, transitions/catalog.md |
| Look up a broader motion-design technique | techniques.md |
| Analyze an existing composition's animation map | scripts/animation-map.mjs |
| GSAP API — timeline / tweens / position parameters | adapters/gsap.md |
| GSAP — drop-in effect recipes | rules/gsap-effects.md |
| GSAP — transforms / perf | adapters/gsap-transforms-and-perf.md |
| GSAP — eases / stagger | adapters/gsap-easing-and-stagger.md |
| GSAP — timeline / labels | adapters/gsap-timeline-and-labels.md |
Lottie / dotLottie (After Effects exports, window.__hfLottie) |
adapters/lottie.md |
Three.js / WebGL (3D scenes, AnimationMixer, hf-seek) |
adapters/three.md |
Anime.js (window.__hfAnime) |
adapters/animejs.md |
CSS keyframes (animation-delay / play-state / fill-mode) |
adapters/css-animations.md |
Web Animations API (element.animate(), currentTime seek) |
adapters/waapi.md |
TypeGPU / WebGPU (navigator.gpu, WGSL, compute pipelines) |
adapters/typegpu.md |
HTML-as-texture + WebGL/GLSL post-fx (capture live DOM via drawElementImage) |
adapters/html-in-canvas-patterns.md |
Named text-animation effects (24 IDs via external animate-text skill) |
adapters/animate-text.md |
Picking a runtime
- GSAP is the default for 95% of motion work — covers timeline orchestration, transforms, easing, stagger. All atomic rules in this skill are GSAP-based.
- Lottie when an asset has its own pre-baked timeline (typically After Effects exports).
- Three.js for 3D scenes, camera motion, shader-driven visuals.
- Anime.js for lightweight tweening when GSAP is overkill.
- CSS for simple repeated motifs, decoration, shimmer — no JavaScript animation cost.
- WAAPI for native browser keyframes without a GSAP dependency.
- TypeGPU / WebGPU for GPU-rendered canvases (particles, liquid glass, custom shaders).
Multiple runtimes can coexist in one composition. Each registers its instances on the runtime-specific global so HyperFrames can seek all of them in one pass.
Critical Constraints
Prerequisite: /hyperframes/core → Non-Negotiable Rules (single paused timeline, data-duration governs length, no Math.random / Date.now / performance.now, no repeat: -1, no gsap.set on later-scene clips, no display / visibility animation, no timeline construction inside async / setTimeout / Promise). Don't restate those here.
Animation-craft additions on top of core's contract:
- Pre-calculated layout constants — never derive positions from
getBoundingClientRect()at tween time. Tween-time DOM measurements desync because the renderer samples in parallel; compute coordinates once at composition setup and reuse. - Spatial motion uses GSAP transform aliases only (
x,y,scale,rotation). Core's allowlist also permitsopacity/color/backgroundColor/borderRadiusfor non-spatial property tweens — but neverwidth/height/top/leftfor layout changes.
Scripts
node skills/hyperframes-motion/scripts/animation-map.mjs <composition-dir> \
--out <composition-dir>/.hyperframes/anim-map
Reads every GSAP timeline registered on window.__timelines, enumerates tweens, samples bboxes, computes flags, outputs animation-map.json. Use it to audit choreography (dead zones, stagger consistency, lifecycle warnings) after authoring.
See Also
/hyperframes→core/— composition structure, data attributes, sub-compositions, deterministic render contract/hyperframes-design— palettes, typography, beat planning (non-animation creative direction)/hyperframes→cli/—npx hyperframes lint / validate / inspect / preview / render
04 同仓库更多 Skills
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
python-api
Programmatic Object-Detection-Metrics API guidance for BoundingBox, BoundingBoxes, Evaluator, enums, coordinate conversion, AP/mAP semantics, and source-style import diagnostics.
file-evaluation
Folder-based PASCAL VOC AP/mAP evaluation from ground-truth and detection text files.
object-detection-metrics
Guides legacy Object-Detection-Metrics PASCAL VOC AP/mAP evaluation from detection text folders and direct Python API classes.
nx-workspace-patterns
Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.