diff --git a/docs/catalog/blocks/app-showcase.mdx b/docs/catalog/blocks/app-showcase.mdx
index 49c816d1c6..7bac206143 100644
--- a/docs/catalog/blocks/app-showcase.mdx
+++ b/docs/catalog/blocks/app-showcase.mdx
@@ -3,49 +3,39 @@ title: "App Showcase"
description: "Fitness app product showcase with three floating smartphone screens"
---
-`showcase` `app` `3d`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the App Showcase block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add app-showcase
```
-## Details
+That writes one file: `compositions/app-showcase.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 5.5s |
+## Add it to your video
-**Installed files**
+It runs for 5.5 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `app-showcase.html` | `compositions/app-showcase.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `showcase` `app` `3d`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/apple-money-count.mdx b/docs/catalog/blocks/apple-money-count.mdx
index 69ee5680da..b4afdbe189 100644
--- a/docs/catalog/blocks/apple-money-count.mdx
+++ b/docs/catalog/blocks/apple-money-count.mdx
@@ -3,57 +3,48 @@ title: "Apple Money Count"
description: "Apple-style finance counter that counts from $0 to $10,000, flashes green, and bursts money icons with sound."
---
-`showcase` `finance` `kinetic` `youtube` `sfx`
+
+
+## Install
+
+```bash Terminal
+npx hyperframes add apple-money-count
+```
+
+That writes `compositions/apple-money-count.html`, plus 1 supporting file under `assets/`.
+
+## Add it to your video
+
+It runs for 5 seconds at 1920Γ1080. Paste this into your composition:
+
+```html index.html
+
+```
+
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `showcase` `finance` `kinetic` `youtube` `sfx`.
Created by [Stronkter](https://x.com/Stronkter).
-## Source Prompt
+
```text
π·HyperFrames by HeyGen Make me a five-second video of, on a white background, of a Apple-style bold font counting from $0 to $10,000. Once it counts to $10,000, it changes to a green color and the screen also flashes green for a second, and then money icons come out of the $10,000 amount all over the screen and then disappear.
```
-
-
-## Add it to a project
-
-### Ask your agent
-
-```text
-Add the Apple Money Count block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
-npx hyperframes add apple-money-count
-```
-
-## Details
-
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 5s |
-
-**Installed files**
-
-| File | Target | Type |
-| --- | --- | --- |
-| `apple-money-count.html` | `compositions/apple-money-count.html` | hyperframes:composition |
-| `assets/sfx-production.wav` | `assets/sfx-production.wav` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
-```
+
## Related topics
diff --git a/docs/catalog/blocks/beat-freeze-cut.mdx b/docs/catalog/blocks/beat-freeze-cut.mdx
index 00c71e08f7..609ca35eb4 100644
--- a/docs/catalog/blocks/beat-freeze-cut.mdx
+++ b/docs/catalog/blocks/beat-freeze-cut.mdx
@@ -3,49 +3,46 @@ title: "Beat Freeze Cut"
description: "A beat-driven speed ramp, freeze-frame hit, and hard-cut sequence for music-led promos and montages."
---
-`transition` `music` `beat-driven` `freeze-frame`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Beat Freeze Cut block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add beat-freeze-cut
```
-## Details
+That writes one file: `compositions/beat-freeze-cut.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 6s |
+## Add it to your video
-**Installed files**
+It runs for 6 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `beat-freeze-cut.html` | `compositions/beat-freeze-cut.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+## Change the colors
+
+Set these CSS variables on the block:
+
+- `--bg-color` β Background. Defaults to `#0B0D10`.
+- `--accent-color` β Accent. Defaults to `#00E5C7`.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `music` `beat-driven` `freeze-frame`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/blue-sweater-intro-video.mdx b/docs/catalog/blocks/blue-sweater-intro-video.mdx
index b179129276..b2493f6609 100644
--- a/docs/catalog/blocks/blue-sweater-intro-video.mdx
+++ b/docs/catalog/blocks/blue-sweater-intro-video.mdx
@@ -3,53 +3,41 @@ title: "Blue Sweater Intro Video"
description: "Warm AI creator intro sequence that resolves into an X follow card for @_blue_sweater_."
---
-`showcase` `ai` `creator` `sfx`
-
-Created by [Joe Sai](https://x.com/_blue_sweater_).
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Blue Sweater Intro Video block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add blue-sweater-intro-video
```
-## Details
+That writes `compositions/blue-sweater-intro-video.html`, plus 2 supporting files under `assets/` and `assets/sfx/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 12s |
+## Add it to your video
-**Installed files**
+It runs for 12 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `blue-sweater-intro-video.html` | `compositions/blue-sweater-intro-video.html` | hyperframes:composition |
-| `assets/joe-sai-avatar.png` | `assets/joe-sai-avatar.png` | hyperframes:asset |
-| `assets/sfx/integrated-melodic-tech-mix.wav` | `assets/sfx/integrated-melodic-tech-mix.wav` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `showcase` `ai` `creator` `sfx`.
+
+Created by [Joe Sai](https://x.com/_blue_sweater_).
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/camcorder-hud.mdx b/docs/catalog/blocks/camcorder-hud.mdx
index 2114cb1d8c..869898e177 100644
--- a/docs/catalog/blocks/camcorder-hud.mdx
+++ b/docs/catalog/blocks/camcorder-hud.mdx
@@ -3,49 +3,39 @@ title: "Camcorder HUD"
description: "Responsive REC, battery, editable date placeholder, and timeline-driven counter overlay for creator-camera and camcorder treatments"
---
-`camcorder` `camera` `recording` `hud` `overlay` `creator` `media-treatment-overlay`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Camcorder HUD block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add camcorder-hud
```
-## Details
+That writes one file: `compositions/camcorder-hud.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4s |
+## Add it to your video
-**Installed files**
+It runs for 4 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `camcorder-hud.html` | `compositions/camcorder-hud.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `camcorder` `camera` `recording` `hud` `overlay` `creator` `media-treatment-overlay`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/chromatic-radial-split.mdx b/docs/catalog/blocks/chromatic-radial-split.mdx
index 6b8c1ce7dc..e2aa85bd76 100644
--- a/docs/catalog/blocks/chromatic-radial-split.mdx
+++ b/docs/catalog/blocks/chromatic-radial-split.mdx
@@ -3,49 +3,39 @@ title: "Chromatic Radial Split"
description: "Shader transition with chromatic aberration radial split"
---
-`transition` `shader`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Chromatic Radial Split block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add chromatic-radial-split
```
-## Details
+That writes one file: `compositions/chromatic-radial-split.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4s |
+## Add it to your video
-**Installed files**
+It runs for 4 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `chromatic-radial-split.html` | `compositions/chromatic-radial-split.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `shader`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/cinematic-zoom.mdx b/docs/catalog/blocks/cinematic-zoom.mdx
index df248f7484..6608bf5cc6 100644
--- a/docs/catalog/blocks/cinematic-zoom.mdx
+++ b/docs/catalog/blocks/cinematic-zoom.mdx
@@ -3,49 +3,39 @@ title: "Cinematic Zoom"
description: "Shader transition with dramatic zoom blur"
---
-`transition` `shader`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Cinematic Zoom block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add cinematic-zoom
```
-## Details
+That writes one file: `compositions/cinematic-zoom.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4s |
+## Add it to your video
-**Installed files**
+It runs for 4 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `cinematic-zoom.html` | `compositions/cinematic-zoom.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `shader`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-3d-extrude.mdx b/docs/catalog/blocks/code-3d-extrude.mdx
index df6685590a..79e664fb7e 100644
--- a/docs/catalog/blocks/code-3d-extrude.mdx
+++ b/docs/catalog/blocks/code-3d-extrude.mdx
@@ -3,49 +3,39 @@ title: "Code 3D Extrude"
description: "Syntax-highlighted code on a lit, beveled 3D slab that rotates through real space and settles to a readable rest β true WebGL depth and lighting, not a 2D transform."
---
-`code` `code-animation` `3d` `webgl` `developer`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code 3D Extrude block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-3d-extrude
```
-## Details
+That writes one file: `compositions/code-3d-extrude.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 8s |
+## Add it to your video
-**Installed files**
+It runs for 8 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-3d-extrude.html` | `compositions/code-3d-extrude.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `code-animation` `3d` `webgl` `developer`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-diff.mdx b/docs/catalog/blocks/code-diff.mdx
index 3c6b0ab8fc..d5cdc69433 100644
--- a/docs/catalog/blocks/code-diff.mdx
+++ b/docs/catalog/blocks/code-diff.mdx
@@ -3,49 +3,39 @@ title: "Code Diff"
description: "An edit shown as a colored diff β removed lines collapse in red, added lines expand in green."
---
-`code` `code-animation` `diff` `developer`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Diff block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-diff
```
-## Details
+That writes one file: `compositions/code-diff.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 6s |
+## Add it to your video
-**Installed files**
+It runs for 6 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-diff.html` | `compositions/code-diff.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `code-animation` `diff` `developer`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-highlight.mdx b/docs/catalog/blocks/code-highlight.mdx
index 24089fbbdd..9088875946 100644
--- a/docs/catalog/blocks/code-highlight.mdx
+++ b/docs/catalog/blocks/code-highlight.mdx
@@ -3,49 +3,39 @@ title: "Code Highlight Sweep"
description: "A highlight band sweeps across a target line while the surrounding context dims β draws the eye to one line. `line` is 0-based: `line: 1` targets the second displayed line (unlike code-scroll, whose target is 1-based)."
---
-`code` `code-animation` `highlight` `developer`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Highlight Sweep block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-highlight
```
-## Details
+That writes one file: `compositions/code-highlight.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 5s |
+## Add it to your video
-**Installed files**
+It runs for 5 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-highlight.html` | `compositions/code-highlight.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `code-animation` `highlight` `developer`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-morph.mdx b/docs/catalog/blocks/code-morph.mdx
index 5795e7ba56..2206351336 100644
--- a/docs/catalog/blocks/code-morph.mdx
+++ b/docs/catalog/blocks/code-morph.mdx
@@ -3,49 +3,39 @@ title: "Code Morph"
description: "One snippet transforms into another β tokens glide between positions, leavers fade out, enterers fade in. Shiki Magic Move re-driven as a paused GSAP timeline."
---
-`code` `code-animation` `morph` `refactor` `developer`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Morph block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-morph
```
-## Details
+That writes one file: `compositions/code-morph.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 7s |
+## Add it to your video
-**Installed files**
+It runs for 7 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-morph.html` | `compositions/code-morph.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `code-animation` `morph` `refactor` `developer`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-particle-assemble.mdx b/docs/catalog/blocks/code-particle-assemble.mdx
index b4aa8a425c..505cab4066 100644
--- a/docs/catalog/blocks/code-particle-assemble.mdx
+++ b/docs/catalog/blocks/code-particle-assemble.mdx
@@ -3,49 +3,39 @@ title: "Code Particle Assemble"
description: "Thousands of GPU points scatter through space and fly to the exact glyph pixels of the code, resolving into readable syntax-highlighted text β a particle system, not a token tween."
---
-`code` `code-animation` `particles` `gpu` `webgl` `developer`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Particle Assemble block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-particle-assemble
```
-## Details
+That writes one file: `compositions/code-particle-assemble.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 8s |
+## Add it to your video
-**Installed files**
+It runs for 8 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-particle-assemble.html` | `compositions/code-particle-assemble.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `code-animation` `particles` `gpu` `webgl` `developer`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-scroll.mdx b/docs/catalog/blocks/code-scroll.mdx
index fdae5829ac..d80bc6974b 100644
--- a/docs/catalog/blocks/code-scroll.mdx
+++ b/docs/catalog/blocks/code-scroll.mdx
@@ -3,49 +3,39 @@ title: "Code Scroll To Line"
description: "The camera scrolls a long file to bring a target line to center and spotlights it β for walking through real modules."
---
-`code` `code-animation` `scroll` `developer`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Scroll To Line block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-scroll
```
-## Details
+That writes one file: `compositions/code-scroll.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 6s |
+## Add it to your video
-**Installed files**
+It runs for 6 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-scroll.html` | `compositions/code-scroll.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `code-animation` `scroll` `developer`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-shader-dissolve.mdx b/docs/catalog/blocks/code-shader-dissolve.mdx
index 4d66dd0a2f..f98e066cc5 100644
--- a/docs/catalog/blocks/code-shader-dissolve.mdx
+++ b/docs/catalog/blocks/code-shader-dissolve.mdx
@@ -3,49 +3,39 @@ title: "Code Shader Dissolve"
description: "The code compiles into existence: a GPU fragment shader resolves it out of seeded noise with a chromatic dissolve front and edge glow, then holds crisp."
---
-`code` `code-animation` `shader` `webgl` `developer`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Shader Dissolve block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-shader-dissolve
```
-## Details
+That writes one file: `compositions/code-shader-dissolve.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 7s |
+## Add it to your video
-**Installed files**
+It runs for 7 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-shader-dissolve.html` | `compositions/code-shader-dissolve.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `code-animation` `shader` `webgl` `developer`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-snippet-apple-terminal-basic.mdx b/docs/catalog/blocks/code-snippet-apple-terminal-basic.mdx
index 012e3f121e..706a8bb607 100644
--- a/docs/catalog/blocks/code-snippet-apple-terminal-basic.mdx
+++ b/docs/catalog/blocks/code-snippet-apple-terminal-basic.mdx
@@ -3,49 +3,39 @@ title: "Code Snippet - Apple Terminal Basic"
description: "Apple Terminal Basic profile: white background, black text, per-character typing animation of a shell session."
---
-`code` `developer` `showcase` `terminal` `apple` `apple-terminal`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Snippet - Apple Terminal Basic block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-snippet-apple-terminal-basic
```
-## Details
+That writes one file: `compositions/code-snippet-apple-terminal-basic.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 12s |
+## Add it to your video
-**Installed files**
+It runs for 12 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-snippet-apple-terminal-basic.html` | `compositions/code-snippet-apple-terminal-basic.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `developer` `showcase` `terminal` `apple` `apple-terminal`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-snippet-apple-terminal-clear-dark.mdx b/docs/catalog/blocks/code-snippet-apple-terminal-clear-dark.mdx
index eebb9b9503..f868bca4b2 100644
--- a/docs/catalog/blocks/code-snippet-apple-terminal-clear-dark.mdx
+++ b/docs/catalog/blocks/code-snippet-apple-terminal-clear-dark.mdx
@@ -3,49 +3,39 @@ title: "Code Snippet - Apple Terminal Clear Dark"
description: "Apple Terminal Clear Dark profile: semi-transparent dark background, per-character typing animation of a shell session."
---
-`code` `developer` `showcase` `terminal` `apple` `apple-terminal`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Snippet - Apple Terminal Clear Dark block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-snippet-apple-terminal-clear-dark
```
-## Details
+That writes one file: `compositions/code-snippet-apple-terminal-clear-dark.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 12s |
+## Add it to your video
-**Installed files**
+It runs for 12 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-snippet-apple-terminal-clear-dark.html` | `compositions/code-snippet-apple-terminal-clear-dark.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `developer` `showcase` `terminal` `apple` `apple-terminal`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-snippet-apple-terminal-clear-light.mdx b/docs/catalog/blocks/code-snippet-apple-terminal-clear-light.mdx
index 2a64bd9aca..94ed3e3c94 100644
--- a/docs/catalog/blocks/code-snippet-apple-terminal-clear-light.mdx
+++ b/docs/catalog/blocks/code-snippet-apple-terminal-clear-light.mdx
@@ -3,49 +3,39 @@ title: "Code Snippet - Apple Terminal Clear Light"
description: "Apple Terminal Clear Light profile: semi-transparent light background, per-character typing animation of a shell session."
---
-`code` `developer` `showcase` `terminal` `apple` `apple-terminal`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Snippet - Apple Terminal Clear Light block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-snippet-apple-terminal-clear-light
```
-## Details
+That writes one file: `compositions/code-snippet-apple-terminal-clear-light.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 12s |
+## Add it to your video
-**Installed files**
+It runs for 12 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-snippet-apple-terminal-clear-light.html` | `compositions/code-snippet-apple-terminal-clear-light.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `developer` `showcase` `terminal` `apple` `apple-terminal`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-snippet-apple-terminal-grass.mdx b/docs/catalog/blocks/code-snippet-apple-terminal-grass.mdx
index 8583a02eea..235ddc2d24 100644
--- a/docs/catalog/blocks/code-snippet-apple-terminal-grass.mdx
+++ b/docs/catalog/blocks/code-snippet-apple-terminal-grass.mdx
@@ -3,49 +3,39 @@ title: "Code Snippet - Apple Terminal Grass"
description: "Apple Terminal Grass profile: black background with green text, per-character typing animation of a shell session."
---
-`code` `developer` `showcase` `terminal` `apple` `apple-terminal`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Snippet - Apple Terminal Grass block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-snippet-apple-terminal-grass
```
-## Details
+That writes one file: `compositions/code-snippet-apple-terminal-grass.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 12s |
+## Add it to your video
-**Installed files**
+It runs for 12 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-snippet-apple-terminal-grass.html` | `compositions/code-snippet-apple-terminal-grass.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `developer` `showcase` `terminal` `apple` `apple-terminal`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-snippet-apple-terminal-homebrew.mdx b/docs/catalog/blocks/code-snippet-apple-terminal-homebrew.mdx
index a2faee9de5..0e18f07ba1 100644
--- a/docs/catalog/blocks/code-snippet-apple-terminal-homebrew.mdx
+++ b/docs/catalog/blocks/code-snippet-apple-terminal-homebrew.mdx
@@ -3,49 +3,39 @@ title: "Code Snippet - Apple Terminal Homebrew"
description: "Apple Terminal Homebrew profile: black background with bright green text and lime cursor, per-character typing animation of a shell session."
---
-`code` `developer` `showcase` `terminal` `apple` `apple-terminal`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Snippet - Apple Terminal Homebrew block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-snippet-apple-terminal-homebrew
```
-## Details
+That writes one file: `compositions/code-snippet-apple-terminal-homebrew.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 12s |
+## Add it to your video
-**Installed files**
+It runs for 12 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-snippet-apple-terminal-homebrew.html` | `compositions/code-snippet-apple-terminal-homebrew.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `developer` `showcase` `terminal` `apple` `apple-terminal`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-snippet-apple-terminal-man-page.mdx b/docs/catalog/blocks/code-snippet-apple-terminal-man-page.mdx
index 62af2f0e85..0afc74ee28 100644
--- a/docs/catalog/blocks/code-snippet-apple-terminal-man-page.mdx
+++ b/docs/catalog/blocks/code-snippet-apple-terminal-man-page.mdx
@@ -3,49 +3,39 @@ title: "Code Snippet - Apple Terminal Man Page"
description: "Apple Terminal Man Page profile: pale yellow background with black text, per-character typing animation of a shell session."
---
-`code` `developer` `showcase` `terminal` `apple` `apple-terminal`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Snippet - Apple Terminal Man Page block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-snippet-apple-terminal-man-page
```
-## Details
+That writes one file: `compositions/code-snippet-apple-terminal-man-page.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 12s |
+## Add it to your video
-**Installed files**
+It runs for 12 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-snippet-apple-terminal-man-page.html` | `compositions/code-snippet-apple-terminal-man-page.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `developer` `showcase` `terminal` `apple` `apple-terminal`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-snippet-apple-terminal-novel.mdx b/docs/catalog/blocks/code-snippet-apple-terminal-novel.mdx
index 9092376779..80b6272e37 100644
--- a/docs/catalog/blocks/code-snippet-apple-terminal-novel.mdx
+++ b/docs/catalog/blocks/code-snippet-apple-terminal-novel.mdx
@@ -3,49 +3,39 @@ title: "Code Snippet - Apple Terminal Novel"
description: "Apple Terminal Novel profile: warm parchment background with dark brown text, per-character typing animation of a shell session."
---
-`code` `developer` `showcase` `terminal` `apple` `apple-terminal`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Snippet - Apple Terminal Novel block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-snippet-apple-terminal-novel
```
-## Details
+That writes one file: `compositions/code-snippet-apple-terminal-novel.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 12s |
+## Add it to your video
-**Installed files**
+It runs for 12 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-snippet-apple-terminal-novel.html` | `compositions/code-snippet-apple-terminal-novel.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `developer` `showcase` `terminal` `apple` `apple-terminal`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-snippet-apple-terminal-ocean.mdx b/docs/catalog/blocks/code-snippet-apple-terminal-ocean.mdx
index 5222330b96..8c0a0d345a 100644
--- a/docs/catalog/blocks/code-snippet-apple-terminal-ocean.mdx
+++ b/docs/catalog/blocks/code-snippet-apple-terminal-ocean.mdx
@@ -3,49 +3,39 @@ title: "Code Snippet - Apple Terminal Ocean"
description: "Apple Terminal Ocean profile: deep blue background with white text, per-character typing animation of a shell session."
---
-`code` `developer` `showcase` `terminal` `apple` `apple-terminal`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Snippet - Apple Terminal Ocean block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-snippet-apple-terminal-ocean
```
-## Details
+That writes one file: `compositions/code-snippet-apple-terminal-ocean.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 12s |
+## Add it to your video
-**Installed files**
+It runs for 12 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-snippet-apple-terminal-ocean.html` | `compositions/code-snippet-apple-terminal-ocean.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `developer` `showcase` `terminal` `apple` `apple-terminal`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-snippet-apple-terminal-pro.mdx b/docs/catalog/blocks/code-snippet-apple-terminal-pro.mdx
index ae3d334174..8868cfe93e 100644
--- a/docs/catalog/blocks/code-snippet-apple-terminal-pro.mdx
+++ b/docs/catalog/blocks/code-snippet-apple-terminal-pro.mdx
@@ -3,49 +3,39 @@ title: "Code Snippet - Apple Terminal Pro"
description: "Apple Terminal Pro profile: black background with grey text and lime green cursor, per-character typing animation of a shell session."
---
-`code` `developer` `showcase` `terminal` `apple` `apple-terminal`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Snippet - Apple Terminal Pro block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-snippet-apple-terminal-pro
```
-## Details
+That writes one file: `compositions/code-snippet-apple-terminal-pro.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 12s |
+## Add it to your video
-**Installed files**
+It runs for 12 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-snippet-apple-terminal-pro.html` | `compositions/code-snippet-apple-terminal-pro.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `developer` `showcase` `terminal` `apple` `apple-terminal`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-snippet-apple-terminal-red-sands.mdx b/docs/catalog/blocks/code-snippet-apple-terminal-red-sands.mdx
index 6a977cdac9..f5502c3829 100644
--- a/docs/catalog/blocks/code-snippet-apple-terminal-red-sands.mdx
+++ b/docs/catalog/blocks/code-snippet-apple-terminal-red-sands.mdx
@@ -3,49 +3,39 @@ title: "Code Snippet - Apple Terminal Red Sands"
description: "Apple Terminal Red Sands profile: deep red background with sandy text, per-character typing animation of a shell session."
---
-`code` `developer` `showcase` `terminal` `apple` `apple-terminal`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Snippet - Apple Terminal Red Sands block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-snippet-apple-terminal-red-sands
```
-## Details
+That writes one file: `compositions/code-snippet-apple-terminal-red-sands.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 12s |
+## Add it to your video
-**Installed files**
+It runs for 12 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-snippet-apple-terminal-red-sands.html` | `compositions/code-snippet-apple-terminal-red-sands.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `developer` `showcase` `terminal` `apple` `apple-terminal`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-snippet-apple-terminal-silver-aerogel.mdx b/docs/catalog/blocks/code-snippet-apple-terminal-silver-aerogel.mdx
index 55709927f5..06ce2faaf9 100644
--- a/docs/catalog/blocks/code-snippet-apple-terminal-silver-aerogel.mdx
+++ b/docs/catalog/blocks/code-snippet-apple-terminal-silver-aerogel.mdx
@@ -3,49 +3,39 @@ title: "Code Snippet - Apple Terminal Silver Aerogel"
description: "Apple Terminal Silver Aerogel profile: dark grey background with white text, per-character typing animation of a shell session."
---
-`code` `developer` `showcase` `terminal` `apple` `apple-terminal`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Snippet - Apple Terminal Silver Aerogel block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-snippet-apple-terminal-silver-aerogel
```
-## Details
+That writes one file: `compositions/code-snippet-apple-terminal-silver-aerogel.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 12s |
+## Add it to your video
-**Installed files**
+It runs for 12 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-snippet-apple-terminal-silver-aerogel.html` | `compositions/code-snippet-apple-terminal-silver-aerogel.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `developer` `showcase` `terminal` `apple` `apple-terminal`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-snippet-apple-terminal-solid-colors.mdx b/docs/catalog/blocks/code-snippet-apple-terminal-solid-colors.mdx
index ebc9150d68..29f801e4a3 100644
--- a/docs/catalog/blocks/code-snippet-apple-terminal-solid-colors.mdx
+++ b/docs/catalog/blocks/code-snippet-apple-terminal-solid-colors.mdx
@@ -3,49 +3,39 @@ title: "Code Snippet - Apple Terminal Solid Colors"
description: "Apple Terminal Solid Colors profile: deep purple background with white text, per-character typing animation of a shell session."
---
-`code` `developer` `showcase` `terminal` `apple` `apple-terminal`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Snippet - Apple Terminal Solid Colors block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-snippet-apple-terminal-solid-colors
```
-## Details
+That writes one file: `compositions/code-snippet-apple-terminal-solid-colors.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 12s |
+## Add it to your video
-**Installed files**
+It runs for 12 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-snippet-apple-terminal-solid-colors.html` | `compositions/code-snippet-apple-terminal-solid-colors.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `developer` `showcase` `terminal` `apple` `apple-terminal`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-snippet-dark-2026.mdx b/docs/catalog/blocks/code-snippet-dark-2026.mdx
index ae7fae7090..6b569a5000 100644
--- a/docs/catalog/blocks/code-snippet-dark-2026.mdx
+++ b/docs/catalog/blocks/code-snippet-dark-2026.mdx
@@ -3,50 +3,39 @@ title: "Code Snippet - Dark 2026"
description: "VS Code workbench with per-character typing animation in the Dark 2026 theme. Full editor chrome with activity bar, sidebar, tabs, terminal, and status bar."
---
-`code` `developer` `showcase` `vscode`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Snippet - Dark 2026 block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-snippet-dark-2026
```
-## Details
+That writes `compositions/code-snippet-dark-2026.html`, plus 1 supporting file under `assets/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 11s |
+## Add it to your video
-**Installed files**
+It runs for 11 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-snippet-dark-2026.html` | `compositions/code-snippet-dark-2026.html` | hyperframes:composition |
-| `background.jpeg` | `assets/background.jpeg` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `developer` `showcase` `vscode`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-snippet-dark-modern.mdx b/docs/catalog/blocks/code-snippet-dark-modern.mdx
index 3c579a397c..4873bc35d7 100644
--- a/docs/catalog/blocks/code-snippet-dark-modern.mdx
+++ b/docs/catalog/blocks/code-snippet-dark-modern.mdx
@@ -3,50 +3,39 @@ title: "Code Snippet - Dark Modern"
description: "VS Code workbench with per-character typing animation in the Dark Modern theme. Full editor chrome with activity bar, sidebar, tabs, terminal, and status bar."
---
-`code` `developer` `showcase` `vscode`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Snippet - Dark Modern block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-snippet-dark-modern
```
-## Details
+That writes `compositions/code-snippet-dark-modern.html`, plus 1 supporting file under `assets/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 11s |
+## Add it to your video
-**Installed files**
+It runs for 11 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-snippet-dark-modern.html` | `compositions/code-snippet-dark-modern.html` | hyperframes:composition |
-| `background.jpeg` | `assets/background.jpeg` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `developer` `showcase` `vscode`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-snippet-dark-plus.mdx b/docs/catalog/blocks/code-snippet-dark-plus.mdx
index 5216159ecb..96430e1cb6 100644
--- a/docs/catalog/blocks/code-snippet-dark-plus.mdx
+++ b/docs/catalog/blocks/code-snippet-dark-plus.mdx
@@ -3,50 +3,39 @@ title: "Code Snippet - Dark+"
description: "VS Code workbench with per-character typing animation in the Dark+ theme. Full editor chrome with activity bar, sidebar, tabs, terminal, and status bar."
---
-`code` `developer` `showcase` `vscode`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Snippet - Dark+ block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-snippet-dark-plus
```
-## Details
+That writes `compositions/code-snippet-dark-plus.html`, plus 1 supporting file under `assets/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 11s |
+## Add it to your video
-**Installed files**
+It runs for 11 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-snippet-dark-plus.html` | `compositions/code-snippet-dark-plus.html` | hyperframes:composition |
-| `background.jpeg` | `assets/background.jpeg` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `developer` `showcase` `vscode`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-snippet-flight.mdx b/docs/catalog/blocks/code-snippet-flight.mdx
index 20c924d123..d81f7f674d 100644
--- a/docs/catalog/blocks/code-snippet-flight.mdx
+++ b/docs/catalog/blocks/code-snippet-flight.mdx
@@ -3,49 +3,39 @@ title: "Code Snippet Flight"
description: "Discrete code snippets fly in from the side and assemble into a stacked program, staggered. Block-level FLIP."
---
-`code` `code-animation` `flight` `developer`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Snippet Flight block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-snippet-flight
```
-## Details
+That writes one file: `compositions/code-snippet-flight.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 6s |
+## Add it to your video
-**Installed files**
+It runs for 6 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-snippet-flight.html` | `compositions/code-snippet-flight.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `code-animation` `flight` `developer`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-snippet-high-contrast-light.mdx b/docs/catalog/blocks/code-snippet-high-contrast-light.mdx
index fa9212bd32..abdc6ab640 100644
--- a/docs/catalog/blocks/code-snippet-high-contrast-light.mdx
+++ b/docs/catalog/blocks/code-snippet-high-contrast-light.mdx
@@ -3,50 +3,39 @@ title: "Code Snippet - High Contrast Light"
description: "VS Code workbench with per-character typing animation in the High Contrast Light theme. Full editor chrome with activity bar, sidebar, tabs, terminal, and status bar."
---
-`code` `developer` `showcase` `vscode`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Snippet - High Contrast Light block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-snippet-high-contrast-light
```
-## Details
+That writes `compositions/code-snippet-high-contrast-light.html`, plus 1 supporting file under `assets/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 11s |
+## Add it to your video
-**Installed files**
+It runs for 11 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-snippet-high-contrast-light.html` | `compositions/code-snippet-high-contrast-light.html` | hyperframes:composition |
-| `background.jpeg` | `assets/background.jpeg` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `developer` `showcase` `vscode`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-snippet-high-contrast.mdx b/docs/catalog/blocks/code-snippet-high-contrast.mdx
index 6c5724f976..12fe78ba84 100644
--- a/docs/catalog/blocks/code-snippet-high-contrast.mdx
+++ b/docs/catalog/blocks/code-snippet-high-contrast.mdx
@@ -3,50 +3,39 @@ title: "Code Snippet - High Contrast"
description: "VS Code workbench with per-character typing animation in the High Contrast theme. Full editor chrome with activity bar, sidebar, tabs, terminal, and status bar."
---
-`code` `developer` `showcase` `vscode`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Snippet - High Contrast block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-snippet-high-contrast
```
-## Details
+That writes `compositions/code-snippet-high-contrast.html`, plus 1 supporting file under `assets/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 11s |
+## Add it to your video
-**Installed files**
+It runs for 11 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-snippet-high-contrast.html` | `compositions/code-snippet-high-contrast.html` | hyperframes:composition |
-| `background.jpeg` | `assets/background.jpeg` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `developer` `showcase` `vscode`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-snippet-light-2026.mdx b/docs/catalog/blocks/code-snippet-light-2026.mdx
index e9eb473d2a..c294f8c434 100644
--- a/docs/catalog/blocks/code-snippet-light-2026.mdx
+++ b/docs/catalog/blocks/code-snippet-light-2026.mdx
@@ -3,50 +3,39 @@ title: "Code Snippet - Light 2026"
description: "VS Code workbench with per-character typing animation in the Light 2026 theme. Full editor chrome with activity bar, sidebar, tabs, terminal, and status bar."
---
-`code` `developer` `showcase` `vscode`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Snippet - Light 2026 block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-snippet-light-2026
```
-## Details
+That writes `compositions/code-snippet-light-2026.html`, plus 1 supporting file under `assets/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 11s |
+## Add it to your video
-**Installed files**
+It runs for 11 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-snippet-light-2026.html` | `compositions/code-snippet-light-2026.html` | hyperframes:composition |
-| `background.jpeg` | `assets/background.jpeg` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `developer` `showcase` `vscode`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-snippet-light-modern.mdx b/docs/catalog/blocks/code-snippet-light-modern.mdx
index 735283f376..d3900ad99b 100644
--- a/docs/catalog/blocks/code-snippet-light-modern.mdx
+++ b/docs/catalog/blocks/code-snippet-light-modern.mdx
@@ -3,50 +3,39 @@ title: "Code Snippet - Light Modern"
description: "VS Code workbench with per-character typing animation in the Light Modern theme. Full editor chrome with activity bar, sidebar, tabs, terminal, and status bar."
---
-`code` `developer` `showcase` `vscode`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Snippet - Light Modern block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-snippet-light-modern
```
-## Details
+That writes `compositions/code-snippet-light-modern.html`, plus 1 supporting file under `assets/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 11s |
+## Add it to your video
-**Installed files**
+It runs for 11 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-snippet-light-modern.html` | `compositions/code-snippet-light-modern.html` | hyperframes:composition |
-| `background.jpeg` | `assets/background.jpeg` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `developer` `showcase` `vscode`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-snippet-light-plus.mdx b/docs/catalog/blocks/code-snippet-light-plus.mdx
index f8fe05189d..f041e2961b 100644
--- a/docs/catalog/blocks/code-snippet-light-plus.mdx
+++ b/docs/catalog/blocks/code-snippet-light-plus.mdx
@@ -3,50 +3,39 @@ title: "Code Snippet - Light+"
description: "VS Code workbench with per-character typing animation in the Light+ theme. Full editor chrome with activity bar, sidebar, tabs, terminal, and status bar."
---
-`code` `developer` `showcase` `vscode`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Snippet - Light+ block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-snippet-light-plus
```
-## Details
+That writes `compositions/code-snippet-light-plus.html`, plus 1 supporting file under `assets/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 11s |
+## Add it to your video
-**Installed files**
+It runs for 11 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-snippet-light-plus.html` | `compositions/code-snippet-light-plus.html` | hyperframes:composition |
-| `background.jpeg` | `assets/background.jpeg` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `developer` `showcase` `vscode`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-snippet-monokai.mdx b/docs/catalog/blocks/code-snippet-monokai.mdx
index 68fb16b7f5..c83dd588f0 100644
--- a/docs/catalog/blocks/code-snippet-monokai.mdx
+++ b/docs/catalog/blocks/code-snippet-monokai.mdx
@@ -3,50 +3,39 @@ title: "Code Snippet - Monokai"
description: "VS Code workbench with per-character typing animation in the Monokai theme. Full editor chrome with activity bar, sidebar, tabs, terminal, and status bar."
---
-`code` `developer` `showcase` `vscode`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Snippet - Monokai block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-snippet-monokai
```
-## Details
+That writes `compositions/code-snippet-monokai.html`, plus 1 supporting file under `assets/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 11s |
+## Add it to your video
-**Installed files**
+It runs for 11 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-snippet-monokai.html` | `compositions/code-snippet-monokai.html` | hyperframes:composition |
-| `background.jpeg` | `assets/background.jpeg` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `developer` `showcase` `vscode`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-snippet-solarized-light.mdx b/docs/catalog/blocks/code-snippet-solarized-light.mdx
index 8a140c3cbc..f6efad7ffd 100644
--- a/docs/catalog/blocks/code-snippet-solarized-light.mdx
+++ b/docs/catalog/blocks/code-snippet-solarized-light.mdx
@@ -3,50 +3,39 @@ title: "Code Snippet - Solarized Light"
description: "VS Code workbench with per-character typing animation in the Solarized Light theme. Full editor chrome with activity bar, sidebar, tabs, terminal, and status bar."
---
-`code` `developer` `showcase` `vscode`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Snippet - Solarized Light block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-snippet-solarized-light
```
-## Details
+That writes `compositions/code-snippet-solarized-light.html`, plus 1 supporting file under `assets/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 11s |
+## Add it to your video
-**Installed files**
+It runs for 11 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-snippet-solarized-light.html` | `compositions/code-snippet-solarized-light.html` | hyperframes:composition |
-| `background.jpeg` | `assets/background.jpeg` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `developer` `showcase` `vscode`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-snippet-visual-studio-dark.mdx b/docs/catalog/blocks/code-snippet-visual-studio-dark.mdx
index c36c3b9f22..f8f46f6c72 100644
--- a/docs/catalog/blocks/code-snippet-visual-studio-dark.mdx
+++ b/docs/catalog/blocks/code-snippet-visual-studio-dark.mdx
@@ -3,50 +3,39 @@ title: "Code Snippet - Visual Studio Dark"
description: "VS Code workbench with per-character typing animation in the Visual Studio Dark theme. Full editor chrome with activity bar, sidebar, tabs, terminal, and status bar."
---
-`code` `developer` `showcase` `vscode`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Snippet - Visual Studio Dark block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-snippet-visual-studio-dark
```
-## Details
+That writes `compositions/code-snippet-visual-studio-dark.html`, plus 1 supporting file under `assets/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 11s |
+## Add it to your video
-**Installed files**
+It runs for 11 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-snippet-visual-studio-dark.html` | `compositions/code-snippet-visual-studio-dark.html` | hyperframes:composition |
-| `background.jpeg` | `assets/background.jpeg` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `developer` `showcase` `vscode`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-snippet-visual-studio-light.mdx b/docs/catalog/blocks/code-snippet-visual-studio-light.mdx
index 1fadf21a2d..efdd243db0 100644
--- a/docs/catalog/blocks/code-snippet-visual-studio-light.mdx
+++ b/docs/catalog/blocks/code-snippet-visual-studio-light.mdx
@@ -3,50 +3,39 @@ title: "Code Snippet - Visual Studio Light"
description: "VS Code workbench with per-character typing animation in the Visual Studio Light theme. Full editor chrome with activity bar, sidebar, tabs, terminal, and status bar."
---
-`code` `developer` `showcase` `vscode`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Snippet - Visual Studio Light block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-snippet-visual-studio-light
```
-## Details
+That writes `compositions/code-snippet-visual-studio-light.html`, plus 1 supporting file under `assets/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 11s |
+## Add it to your video
-**Installed files**
+It runs for 11 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-snippet-visual-studio-light.html` | `compositions/code-snippet-visual-studio-light.html` | hyperframes:composition |
-| `background.jpeg` | `assets/background.jpeg` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `developer` `showcase` `vscode`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/code-typing.mdx b/docs/catalog/blocks/code-typing.mdx
index a7c43b83dc..726ea5c6c6 100644
--- a/docs/catalog/blocks/code-typing.mdx
+++ b/docs/catalog/blocks/code-typing.mdx
@@ -3,49 +3,39 @@ title: "Code Typing"
description: "Token-streamed typing reveal with a caret that tracks the frontier β deterministic, no CSS animation."
---
-`code` `code-animation` `typing` `developer`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Code Typing block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add code-typing
```
-## Details
+That writes one file: `compositions/code-typing.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 5s |
+## Add it to your video
-**Installed files**
+It runs for 5 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `code-typing.html` | `compositions/code-typing.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `code` `code-animation` `typing` `developer`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/cross-warp-morph.mdx b/docs/catalog/blocks/cross-warp-morph.mdx
index 346ebc2e19..8b3c32efb3 100644
--- a/docs/catalog/blocks/cross-warp-morph.mdx
+++ b/docs/catalog/blocks/cross-warp-morph.mdx
@@ -3,49 +3,39 @@ title: "Cross Warp Morph"
description: "Shader transition with cross-warped morphing"
---
-`transition` `shader`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Cross Warp Morph block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add cross-warp-morph
```
-## Details
+That writes one file: `compositions/cross-warp-morph.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4s |
+## Add it to your video
-**Installed files**
+It runs for 4 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `cross-warp-morph.html` | `compositions/cross-warp-morph.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `shader`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/data-chart.mdx b/docs/catalog/blocks/data-chart.mdx
index 427cc7c5f8..279fa08723 100644
--- a/docs/catalog/blocks/data-chart.mdx
+++ b/docs/catalog/blocks/data-chart.mdx
@@ -3,49 +3,46 @@ title: "Data Chart"
description: "Animated bar + line chart with staggered reveal, NYT-style typography, and value labels"
---
-`data` `chart` `statistics`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Data Chart block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add data-chart
```
-## Details
+That writes one file: `compositions/data-chart.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 15s |
+## Add it to your video
-**Installed files**
+It runs for 15 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `data-chart.html` | `compositions/data-chart.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+## Change the colors
+
+Set these CSS variables on the block:
+
+- `--bg-color` β Background. Defaults to `#faf9f6`.
+- `--text-color` β Text color. Defaults to `#333333`.
+
+{/* hf:generated-footer */}
+
+Tagged `data` `chart` `statistics`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/domain-warp-dissolve.mdx b/docs/catalog/blocks/domain-warp-dissolve.mdx
index 3bd87774e5..ed9e581995 100644
--- a/docs/catalog/blocks/domain-warp-dissolve.mdx
+++ b/docs/catalog/blocks/domain-warp-dissolve.mdx
@@ -3,49 +3,39 @@ title: "Domain Warp Dissolve"
description: "Shader transition with fractal noise domain warping"
---
-`transition` `shader`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Domain Warp Dissolve block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add domain-warp-dissolve
```
-## Details
+That writes one file: `compositions/domain-warp-dissolve.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4s |
+## Add it to your video
-**Installed files**
+It runs for 4 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `domain-warp-dissolve.html` | `compositions/domain-warp-dissolve.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `shader`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/editorial-flash-overlay.mdx b/docs/catalog/blocks/editorial-flash-overlay.mdx
index db4d5a2a67..d816ccc781 100644
--- a/docs/catalog/blocks/editorial-flash-overlay.mdx
+++ b/docs/catalog/blocks/editorial-flash-overlay.mdx
@@ -3,49 +3,39 @@ title: "Editorial Flash Overlay"
description: "Finite neutral-warm light layers for a seek-safe camera-flash cut or social reveal"
---
-`flash` `editorial` `social` `light` `transition` `overlay` `media-treatment-overlay`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Editorial Flash Overlay block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add editorial-flash-overlay
```
-## Details
+That writes one file: `compositions/editorial-flash-overlay.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4s |
+## Add it to your video
-**Installed files**
+It runs for 4 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `editorial-flash-overlay.html` | `compositions/editorial-flash-overlay.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `flash` `editorial` `social` `light` `transition` `overlay` `media-treatment-overlay`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/flash-through-white.mdx b/docs/catalog/blocks/flash-through-white.mdx
index f85df513e7..c10d69424f 100644
--- a/docs/catalog/blocks/flash-through-white.mdx
+++ b/docs/catalog/blocks/flash-through-white.mdx
@@ -3,49 +3,39 @@ title: "Flash Through White"
description: "Shader transition with white flash crossfade"
---
-`transition` `shader`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Flash Through White block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add flash-through-white
```
-## Details
+That writes one file: `compositions/flash-through-white.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4s |
+## Add it to your video
-**Installed files**
+It runs for 4 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `flash-through-white.html` | `compositions/flash-through-white.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `shader`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/flowchart-vertical.mdx b/docs/catalog/blocks/flowchart-vertical.mdx
index eb128fe3d1..150d75536f 100644
--- a/docs/catalog/blocks/flowchart-vertical.mdx
+++ b/docs/catalog/blocks/flowchart-vertical.mdx
@@ -3,49 +3,39 @@ title: "Flowchart Vertical"
description: "Portrait animated decision tree with SVG connectors, sticky-note nodes, cursor interaction, and typing correction"
---
-`diagram` `flowchart` `interactive` `portrait`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Flowchart Vertical block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add flowchart-vertical
```
-## Details
+That writes one file: `compositions/flowchart-vertical.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1440Γ2560 |
-| Duration | 12s |
+## Add it to your video
-**Installed files**
+It runs for 12 seconds at 1440Γ2560. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `flowchart-vertical.html` | `compositions/flowchart-vertical.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `diagram` `flowchart` `interactive` `portrait`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/flowchart.mdx b/docs/catalog/blocks/flowchart.mdx
index 0dbb6f7a8c..8e45923c5f 100644
--- a/docs/catalog/blocks/flowchart.mdx
+++ b/docs/catalog/blocks/flowchart.mdx
@@ -3,49 +3,39 @@ title: "Flowchart"
description: "Animated decision tree with SVG connectors, sticky-note nodes, cursor interaction, and typing correction"
---
-`diagram` `flowchart` `interactive`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Flowchart block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add flowchart
```
-## Details
+That writes one file: `compositions/flowchart.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 12s |
+## Add it to your video
-**Installed files**
+It runs for 12 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `flowchart.html` | `compositions/flowchart.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `diagram` `flowchart` `interactive`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/freeze-frame-dressing.mdx b/docs/catalog/blocks/freeze-frame-dressing.mdx
index 2acd7eb4d6..e8a0e0d943 100644
--- a/docs/catalog/blocks/freeze-frame-dressing.mdx
+++ b/docs/catalog/blocks/freeze-frame-dressing.mdx
@@ -3,49 +3,39 @@ title: "Freeze-Frame Dressing"
description: "Timeline-driven paper, tape, and flash dressing for a freeze-frame or background-removed subject"
---
-`freeze-frame` `cutout` `scrapbook` `paper` `social` `overlay` `media-treatment-overlay`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Freeze-Frame Dressing block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add freeze-frame-dressing
```
-## Details
+That writes one file: `compositions/freeze-frame-dressing.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4s |
+## Add it to your video
-**Installed files**
+It runs for 4 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `freeze-frame-dressing.html` | `compositions/freeze-frame-dressing.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `freeze-frame` `cutout` `scrapbook` `paper` `social` `overlay` `media-treatment-overlay`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/glitch.mdx b/docs/catalog/blocks/glitch.mdx
index 67cdf5307d..2df95eb7fd 100644
--- a/docs/catalog/blocks/glitch.mdx
+++ b/docs/catalog/blocks/glitch.mdx
@@ -3,49 +3,39 @@ title: "Glitch"
description: "Shader transition with digital glitch artifacts"
---
-`transition` `shader`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Glitch block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add glitch
```
-## Details
+That writes one file: `compositions/glitch.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4s |
+## Add it to your video
-**Installed files**
+It runs for 4 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `glitch.html` | `compositions/glitch.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `shader`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/gravitational-lens.mdx b/docs/catalog/blocks/gravitational-lens.mdx
index 3220254253..01f12ebfd8 100644
--- a/docs/catalog/blocks/gravitational-lens.mdx
+++ b/docs/catalog/blocks/gravitational-lens.mdx
@@ -3,49 +3,39 @@ title: "Gravitational Lens"
description: "Shader transition with gravitational lensing distortion"
---
-`transition` `shader`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Gravitational Lens block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add gravitational-lens
```
-## Details
+That writes one file: `compositions/gravitational-lens.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4s |
+## Add it to your video
-**Installed files**
+It runs for 4 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `gravitational-lens.html` | `compositions/gravitational-lens.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `shader`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/hw-frame.mdx b/docs/catalog/blocks/hw-frame.mdx
index 65f265d95f..7515993d85 100644
--- a/docs/catalog/blocks/hw-frame.mdx
+++ b/docs/catalog/blocks/hw-frame.mdx
@@ -3,50 +3,39 @@ title: "Sketched Frame"
description: "Media in a hand-drawn border with corner doodles and a handwritten caption; the unit tilts slightly and boils (images inside the block; keep live footage in the host)"
---
-`handwritten` `frame` `media`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Sketched Frame block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add hw-frame
```
-## Details
+That writes `compositions/hw-frame.html`, plus 1 supporting file under `assets/fonts/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 8s |
+## Add it to your video
-**Installed files**
+It runs for 8 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `hw-frame.html` | `compositions/hw-frame.html` | hyperframes:composition |
-| `assets/fonts/Caveat-700-latin.woff2` | `assets/fonts/Caveat-700-latin.woff2` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `handwritten` `frame` `media`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/hw-path-text.mdx b/docs/catalog/blocks/hw-path-text.mdx
index eb9ddb14f8..74592ac67f 100644
--- a/docs/catalog/blocks/hw-path-text.mdx
+++ b/docs/catalog/blocks/hw-path-text.mdx
@@ -3,50 +3,39 @@ title: "Text Along a Path"
description: "Handwriting flowing along any SVG path with a per-character reveal; the path is the only geometry input"
---
-`handwritten` `typography` `path` `overlay`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Text Along a Path block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add hw-path-text
```
-## Details
+That writes `compositions/hw-path-text.html`, plus 1 supporting file under `assets/fonts/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 6s |
+## Add it to your video
-**Installed files**
+It runs for 6 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `hw-path-text.html` | `compositions/hw-path-text.html` | hyperframes:composition |
-| `assets/fonts/Caveat-700-latin.woff2` | `assets/fonts/Caveat-700-latin.woff2` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `handwritten` `typography` `path` `overlay`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/hw-pipeline.mdx b/docs/catalog/blocks/hw-pipeline.mdx
index 75e801e736..969855905e 100644
--- a/docs/catalog/blocks/hw-pipeline.mdx
+++ b/docs/catalog/blocks/hw-pipeline.mdx
@@ -3,50 +3,39 @@ title: "Hand-Drawn Flowchart"
description: "Wobbled boxes with handwritten labels joined by curved connectors, drawing on in sequence from a node list"
---
-`handwritten` `diagram` `data-viz` `overlay`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Hand-Drawn Flowchart block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add hw-pipeline
```
-## Details
+That writes `compositions/hw-pipeline.html`, plus 1 supporting file under `assets/fonts/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 7s |
+## Add it to your video
-**Installed files**
+It runs for 7 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `hw-pipeline.html` | `compositions/hw-pipeline.html` | hyperframes:composition |
-| `assets/fonts/Caveat-700-latin.woff2` | `assets/fonts/Caveat-700-latin.woff2` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `handwritten` `diagram` `data-viz` `overlay`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/hw-scribble-transition.mdx b/docs/catalog/blocks/hw-scribble-transition.mdx
index 943055e58c..3c672f8775 100644
--- a/docs/catalog/blocks/hw-scribble-transition.mdx
+++ b/docs/catalog/blocks/hw-scribble-transition.mdx
@@ -3,49 +3,39 @@ title: "Scribble Transition"
description: "Overlay transition: scribble bands accumulate to cover the frame with a solid backstop, the host cuts beneath, and the scribble clears"
---
-`handwritten` `transition` `wipe`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Scribble Transition block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add hw-scribble-transition
```
-## Details
+That writes one file: `compositions/hw-scribble-transition.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 2.2s |
+## Add it to your video
-**Installed files**
+It runs for 2.2 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `hw-scribble-transition.html` | `compositions/hw-scribble-transition.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `handwritten` `transition` `wipe`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/hw-text-cloud.mdx b/docs/catalog/blocks/hw-text-cloud.mdx
index c08c39b791..6cb7a489fa 100644
--- a/docs/catalog/blocks/hw-text-cloud.mdx
+++ b/docs/catalog/blocks/hw-text-cloud.mdx
@@ -3,50 +3,39 @@ title: "Speech Bubble"
description: "Hand-drawn speech bubble with a positionable tail: outline draws on, paper fill fades in, handwritten text types per character; boils"
---
-`handwritten` `speech-bubble` `overlay`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Speech Bubble block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add hw-text-cloud
```
-## Details
+That writes `compositions/hw-text-cloud.html`, plus 1 supporting file under `assets/fonts/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 6s |
+## Add it to your video
-**Installed files**
+It runs for 6 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `hw-text-cloud.html` | `compositions/hw-text-cloud.html` | hyperframes:composition |
-| `assets/fonts/Caveat-700-latin.woff2` | `assets/fonts/Caveat-700-latin.woff2` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `handwritten` `speech-bubble` `overlay`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/hw-title.mdx b/docs/catalog/blocks/hw-title.mdx
index 9c26f47f0a..d6c22ba167 100644
--- a/docs/catalog/blocks/hw-title.mdx
+++ b/docs/catalog/blocks/hw-title.mdx
@@ -3,50 +3,39 @@ title: "Handwritten Title"
description: "Handwritten display text with a scalar-driven word-by-word highlight sweep and a seeded squiggle underline sized to the text; boils"
---
-`handwritten` `typography` `title-card` `overlay`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Handwritten Title block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add hw-title
```
-## Details
+That writes `compositions/hw-title.html`, plus 1 supporting file under `assets/fonts/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 6s |
+## Add it to your video
-**Installed files**
+It runs for 6 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `hw-title.html` | `compositions/hw-title.html` | hyperframes:composition |
-| `assets/fonts/Caveat-700-latin.woff2` | `assets/fonts/Caveat-700-latin.woff2` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `handwritten` `typography` `title-card` `overlay`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/instagram-follow.mdx b/docs/catalog/blocks/instagram-follow.mdx
index 58abe9c56f..82dc2bb456 100644
--- a/docs/catalog/blocks/instagram-follow.mdx
+++ b/docs/catalog/blocks/instagram-follow.mdx
@@ -3,50 +3,39 @@ title: "Instagram Follow"
description: "Animated Instagram follow overlay with profile card and follow button"
---
-`social` `overlay` `instagram`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Instagram Follow block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add instagram-follow
```
-## Details
+That writes `compositions/instagram-follow.html`, plus 1 supporting file under `assets/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1080Γ1920 |
-| Duration | 4.5s |
+## Add it to your video
-**Installed files**
+It runs for 4.5 seconds at 1080Γ1920. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `instagram-follow.html` | `compositions/instagram-follow.html` | hyperframes:composition |
-| `assets/avatar.jpg` | `assets/avatar.jpg` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `social` `overlay` `instagram`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/ios26-liquid-glass.mdx b/docs/catalog/blocks/ios26-liquid-glass.mdx
index 0bdfe3edcf..dd2176d725 100644
--- a/docs/catalog/blocks/ios26-liquid-glass.mdx
+++ b/docs/catalog/blocks/ios26-liquid-glass.mdx
@@ -3,81 +3,45 @@ title: "iOS 26 Liquid Glass Home Screen"
description: "3D iPhone with a normal iOS 26 home screen, liquid glass app icons, shader wallpaper, dock, and fluid glass notifications that drop from the status area onto a GLTF device model."
---
-`liquid-glass-html-in-canvas` `webgpu` `3d` `iphone` `ios26` `notifications` `gltf` `html-in-canvas`
-
-
-**Requires Chrome flag.** Enable `chrome://flags/#canvas-draw-element` for live preview. Rendering via CLI enables the flag automatically. [Learn more](/guides/html-in-canvas).
-
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the iOS 26 Liquid Glass Home Screen block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add ios26-liquid-glass
```
-## Details
+That writes `compositions/ios26-liquid-glass.html`, plus 28 supporting files under `models/`, `lib/`, and `assets/icons/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 15s |
+
+ Live preview needs the `chrome://flags/#canvas-draw-element` flag switched on.
+ Rendering from the CLI switches it on for you. [How it
+ works](/guides/html-in-canvas)
+
-**Installed files**
+## Add it to your video
-| File | Target | Type |
-| --- | --- | --- |
-| `ios26-liquid-glass.html` | `compositions/ios26-liquid-glass.html` | hyperframes:composition |
-| `models/iphone.glb` | `models/iphone.glb` | hyperframes:asset |
-| `lib/liquid-glass.iife.js` | `lib/liquid-glass.iife.js` | hyperframes:asset |
-| `assets/icons/weather.jpg` | `assets/icons/weather.jpg` | hyperframes:asset |
-| `assets/icons/stocks.jpg` | `assets/icons/stocks.jpg` | hyperframes:asset |
-| `assets/icons/find-my.jpg` | `assets/icons/find-my.jpg` | hyperframes:asset |
-| `assets/icons/home.jpg` | `assets/icons/home.jpg` | hyperframes:asset |
-| `assets/icons/books.jpg` | `assets/icons/books.jpg` | hyperframes:asset |
-| `assets/icons/itunes-store.jpg` | `assets/icons/itunes-store.jpg` | hyperframes:asset |
-| `assets/icons/fitness.jpg` | `assets/icons/fitness.jpg` | hyperframes:asset |
-| `assets/icons/watch.jpg` | `assets/icons/watch.jpg` | hyperframes:asset |
-| `assets/icons/contacts.jpg` | `assets/icons/contacts.jpg` | hyperframes:asset |
-| `assets/icons/files.jpg` | `assets/icons/files.jpg` | hyperframes:asset |
-| `assets/icons/translate.jpg` | `assets/icons/translate.jpg` | hyperframes:asset |
-| `assets/icons/calendar.jpg` | `assets/icons/calendar.jpg` | hyperframes:asset |
-| `assets/icons/chatgpt.jpg` | `assets/icons/chatgpt.jpg` | hyperframes:asset |
-| `assets/icons/slack.jpg` | `assets/icons/slack.jpg` | hyperframes:asset |
-| `assets/icons/instagram.jpg` | `assets/icons/instagram.jpg` | hyperframes:asset |
-| `assets/icons/x.jpg` | `assets/icons/x.jpg` | hyperframes:asset |
-| `assets/icons/proton-mail.jpg` | `assets/icons/proton-mail.jpg` | hyperframes:asset |
-| `assets/icons/gmail.jpg` | `assets/icons/gmail.jpg` | hyperframes:asset |
-| `assets/icons/revolut.jpg` | `assets/icons/revolut.jpg` | hyperframes:asset |
-| `assets/icons/photos.jpg` | `assets/icons/photos.jpg` | hyperframes:asset |
-| `assets/icons/phone.jpg` | `assets/icons/phone.jpg` | hyperframes:asset |
-| `assets/icons/brave.jpg` | `assets/icons/brave.jpg` | hyperframes:asset |
-| `assets/icons/messages.jpg` | `assets/icons/messages.jpg` | hyperframes:asset |
-| `assets/icons/whatsapp.jpg` | `assets/icons/whatsapp.jpg` | hyperframes:asset |
-| `assets/icons/notify-messages.jpg` | `assets/icons/notify-messages.jpg` | hyperframes:asset |
-| `assets/icons/music.jpg` | `assets/icons/music.jpg` | hyperframes:asset |
+It runs for 15 seconds at 1920Γ1080. Paste this into your composition:
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `liquid-glass-html-in-canvas` `webgpu` `3d` `iphone` `ios26` `notifications` `gltf` `html-in-canvas`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/light-leak.mdx b/docs/catalog/blocks/light-leak.mdx
index 2220b42b98..c5bd15150e 100644
--- a/docs/catalog/blocks/light-leak.mdx
+++ b/docs/catalog/blocks/light-leak.mdx
@@ -3,49 +3,39 @@ title: "Light Leak"
description: "Shader transition with cinematic light leak overlay"
---
-`transition` `shader`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Light Leak block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add light-leak
```
-## Details
+That writes one file: `compositions/light-leak.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4s |
+## Add it to your video
-**Installed files**
+It runs for 4 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `light-leak.html` | `compositions/light-leak.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `shader`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/liquid-glass-context-menu.mdx b/docs/catalog/blocks/liquid-glass-context-menu.mdx
index 98339d71b8..06eacb5995 100644
--- a/docs/catalog/blocks/liquid-glass-context-menu.mdx
+++ b/docs/catalog/blocks/liquid-glass-context-menu.mdx
@@ -3,54 +3,45 @@ title: "Liquid Glass Context Menu"
description: "Frosted glass context menu panel drifting over an aurora shader background"
---
-`html-in-canvas` `liquid-glass-html-in-canvas` `webgpu`
-
-
-**Requires Chrome flag.** Enable `chrome://flags/#canvas-draw-element` for live preview. Rendering via CLI enables the flag automatically. [Learn more](/guides/html-in-canvas).
-
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Liquid Glass Context Menu block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add liquid-glass-context-menu
```
-## Details
+That writes `compositions/liquid-glass-context-menu.html`, plus 1 supporting file under `compositions/lib/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 8s |
+
+ Live preview needs the `chrome://flags/#canvas-draw-element` flag switched on.
+ Rendering from the CLI switches it on for you. [How it
+ works](/guides/html-in-canvas)
+
-**Installed files**
+## Add it to your video
-| File | Target | Type |
-| --- | --- | --- |
-| `liquid-glass-context-menu.html` | `compositions/liquid-glass-context-menu.html` | hyperframes:composition |
-| `lib/liquid-glass.iife.js` | `compositions/lib/liquid-glass.iife.js` | registry:asset |
+It runs for 8 seconds at 1920Γ1080. Paste this into your composition:
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `html-in-canvas` `liquid-glass-html-in-canvas` `webgpu`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/liquid-glass-media-controls.mdx b/docs/catalog/blocks/liquid-glass-media-controls.mdx
index cdd934861f..9e21431d33 100644
--- a/docs/catalog/blocks/liquid-glass-media-controls.mdx
+++ b/docs/catalog/blocks/liquid-glass-media-controls.mdx
@@ -3,54 +3,45 @@ title: "Liquid Glass Media Controls"
description: "Frosted glass media control panels spreading over an aurora shader background"
---
-`html-in-canvas` `liquid-glass-html-in-canvas` `webgpu`
-
-
-**Requires Chrome flag.** Enable `chrome://flags/#canvas-draw-element` for live preview. Rendering via CLI enables the flag automatically. [Learn more](/guides/html-in-canvas).
-
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Liquid Glass Media Controls block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add liquid-glass-media-controls
```
-## Details
+That writes `compositions/liquid-glass-media-controls.html`, plus 1 supporting file under `compositions/lib/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 8s |
+
+ Live preview needs the `chrome://flags/#canvas-draw-element` flag switched on.
+ Rendering from the CLI switches it on for you. [How it
+ works](/guides/html-in-canvas)
+
-**Installed files**
+## Add it to your video
-| File | Target | Type |
-| --- | --- | --- |
-| `liquid-glass-media-controls.html` | `compositions/liquid-glass-media-controls.html` | hyperframes:composition |
-| `lib/liquid-glass.iife.js` | `compositions/lib/liquid-glass.iife.js` | registry:asset |
+It runs for 8 seconds at 1920Γ1080. Paste this into your composition:
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `html-in-canvas` `liquid-glass-html-in-canvas` `webgpu`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/liquid-glass-notification.mdx b/docs/catalog/blocks/liquid-glass-notification.mdx
index 8c092dfac5..9b4ae2cb94 100644
--- a/docs/catalog/blocks/liquid-glass-notification.mdx
+++ b/docs/catalog/blocks/liquid-glass-notification.mdx
@@ -3,55 +3,45 @@ title: "Liquid Glass Notification"
description: "Frosted glass notification cards floating over an aurora shader background"
---
-`html-in-canvas` `liquid-glass-html-in-canvas` `webgpu`
-
-
-**Requires Chrome flag.** Enable `chrome://flags/#canvas-draw-element` for live preview. Rendering via CLI enables the flag automatically. [Learn more](/guides/html-in-canvas).
-
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Liquid Glass Notification block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add liquid-glass-notification
```
-## Details
+That writes `compositions/liquid-glass-notification.html`, plus 2 supporting files under `compositions/lib/` and `compositions/assets/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 8s |
+
+ Live preview needs the `chrome://flags/#canvas-draw-element` flag switched on.
+ Rendering from the CLI switches it on for you. [How it
+ works](/guides/html-in-canvas)
+
-**Installed files**
+## Add it to your video
-| File | Target | Type |
-| --- | --- | --- |
-| `liquid-glass-notification.html` | `compositions/liquid-glass-notification.html` | hyperframes:composition |
-| `lib/liquid-glass.iife.js` | `compositions/lib/liquid-glass.iife.js` | registry:asset |
-| `assets/hyperframes-logo-dark.svg` | `compositions/assets/hyperframes-logo-dark.svg` | registry:asset |
+It runs for 8 seconds at 1920Γ1080. Paste this into your composition:
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `html-in-canvas` `liquid-glass-html-in-canvas` `webgpu`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/liquid-glass-widgets.mdx b/docs/catalog/blocks/liquid-glass-widgets.mdx
index 58fafbfc3a..261209937b 100644
--- a/docs/catalog/blocks/liquid-glass-widgets.mdx
+++ b/docs/catalog/blocks/liquid-glass-widgets.mdx
@@ -3,55 +3,45 @@ title: "Liquid Glass Widgets"
description: "Frosted glass stat cards, showcase panel and pill chips over an aurora shader background"
---
-`html-in-canvas` `liquid-glass-html-in-canvas` `webgpu`
-
-
-**Requires Chrome flag.** Enable `chrome://flags/#canvas-draw-element` for live preview. Rendering via CLI enables the flag automatically. [Learn more](/guides/html-in-canvas).
-
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Liquid Glass Widgets block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add liquid-glass-widgets
```
-## Details
+That writes `compositions/liquid-glass-widgets.html`, plus 2 supporting files under `compositions/assets/` and `compositions/lib/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 8s |
+
+ Live preview needs the `chrome://flags/#canvas-draw-element` flag switched on.
+ Rendering from the CLI switches it on for you. [How it
+ works](/guides/html-in-canvas)
+
-**Installed files**
+## Add it to your video
-| File | Target | Type |
-| --- | --- | --- |
-| `liquid-glass-widgets.html` | `compositions/liquid-glass-widgets.html` | hyperframes:composition |
-| `assets/hyperframes-logo-dark.svg` | `compositions/assets/hyperframes-logo-dark.svg` | registry:asset |
-| `lib/liquid-glass.iife.js` | `compositions/lib/liquid-glass.iife.js` | registry:asset |
+It runs for 8 seconds at 1920Γ1080. Paste this into your composition:
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `html-in-canvas` `liquid-glass-html-in-canvas` `webgpu`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/logo-outro.mdx b/docs/catalog/blocks/logo-outro.mdx
index 676958ee8d..21a7171044 100644
--- a/docs/catalog/blocks/logo-outro.mdx
+++ b/docs/catalog/blocks/logo-outro.mdx
@@ -3,49 +3,46 @@ title: "Logo Outro"
description: "Cinematic logo reveal with piece-by-piece assembly, glow bloom, tagline fade-in, and URL pill"
---
-`branding` `outro` `logo`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Logo Outro block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add logo-outro
```
-## Details
+That writes one file: `compositions/logo-outro.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 6s |
+## Add it to your video
-**Installed files**
+It runs for 6 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `logo-outro.html` | `compositions/logo-outro.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+## Change the colors
+
+Set these CSS variables on the block:
+
+- `--bg-color` β Background. Defaults to `#0a0a0f`.
+- `--accent-color` β Accent. Defaults to `#1a1a1f`.
+
+{/* hf:generated-footer */}
+
+Tagged `branding` `outro` `logo`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/lower-third-bild.mdx b/docs/catalog/blocks/lower-third-bild.mdx
index 42bc83ecf0..8fe0ae306d 100644
--- a/docs/catalog/blocks/lower-third-bild.mdx
+++ b/docs/catalog/blocks/lower-third-bild.mdx
@@ -3,51 +3,39 @@ title: "Lower Third β BILD Style"
description: "News-style lower third with tight-fit text boxes: white headline bar with red drop-shadow, red sub-line with white drop-shadow."
---
-`broadcast` `lower-third` `news` `overlay`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Lower Third β BILD Style block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add lower-third-bild
```
-## Details
+That writes `compositions/lower-third-bild.html`, plus 2 supporting files under `compositions/assets/fonts/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 8s |
+## Add it to your video
-**Installed files**
+It runs for 8 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `lower-third-bild.html` | `compositions/lower-third-bild.html` | hyperframes:composition |
-| `assets/fonts/BarlowCondensed-Bold.woff2` | `compositions/assets/fonts/BarlowCondensed-Bold.woff2` | hyperframes:asset |
-| `assets/fonts/BarlowCondensed-ExtraBold.woff2` | `compositions/assets/fonts/BarlowCondensed-ExtraBold.woff2` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `broadcast` `lower-third` `news` `overlay`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/lt-accent-underline.mdx b/docs/catalog/blocks/lt-accent-underline.mdx
index 59a4111b2a..2e972e10f9 100644
--- a/docs/catalog/blocks/lt-accent-underline.mdx
+++ b/docs/catalog/blocks/lt-accent-underline.mdx
@@ -3,49 +3,39 @@ title: "Lower Third β Accent Underline"
description: "Cardless lower third for footage overlay: name rises, an accent rule draws left-to-right, role fades in; text-shadowed for legibility"
---
-`lower-third` `overlay` `podcast` `interview` `minimal`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Lower Third β Accent Underline block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add lt-accent-underline
```
-## Details
+That writes one file: `compositions/lt-accent-underline.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4.8s |
+## Add it to your video
-**Installed files**
+It runs for 4.8 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `lt-accent-underline.html` | `compositions/lt-accent-underline.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `lower-third` `overlay` `podcast` `interview` `minimal`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/lt-bold-block.mdx b/docs/catalog/blocks/lt-bold-block.mdx
index dfa9623c4b..9a2f93d384 100644
--- a/docs/catalog/blocks/lt-bold-block.mdx
+++ b/docs/catalog/blocks/lt-bold-block.mdx
@@ -3,49 +3,39 @@ title: "Lower Third β Bold Block"
description: "High-energy podcast lower third: solid dark block wipes in, uppercase name slams up, accent tag pops"
---
-`lower-third` `overlay` `podcast` `interview` `bold`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Lower Third β Bold Block block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add lt-bold-block
```
-## Details
+That writes one file: `compositions/lt-bold-block.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4.8s |
+## Add it to your video
-**Installed files**
+It runs for 4.8 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `lt-bold-block.html` | `compositions/lt-bold-block.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `lower-third` `overlay` `podcast` `interview` `bold`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/lt-clean-bar.mdx b/docs/catalog/blocks/lt-clean-bar.mdx
index 59129b4a7f..03c18ffb89 100644
--- a/docs/catalog/blocks/lt-clean-bar.mdx
+++ b/docs/catalog/blocks/lt-clean-bar.mdx
@@ -3,49 +3,39 @@ title: "Lower Third β Clean Bar"
description: "Minimal white-card lower third for podcasts/interviews: accent tab, name + role, clip-wipe entrance"
---
-`lower-third` `overlay` `podcast` `interview`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Lower Third β Clean Bar block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add lt-clean-bar
```
-## Details
+That writes one file: `compositions/lt-clean-bar.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4.8s |
+## Add it to your video
-**Installed files**
+It runs for 4.8 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `lt-clean-bar.html` | `compositions/lt-clean-bar.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `lower-third` `overlay` `podcast` `interview`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/lt-color-block.mdx b/docs/catalog/blocks/lt-color-block.mdx
index 8f2a845bde..90ddf3a39b 100644
--- a/docs/catalog/blocks/lt-color-block.mdx
+++ b/docs/catalog/blocks/lt-color-block.mdx
@@ -3,49 +3,39 @@ title: "Lower Third β Color Block"
description: "High-energy lower third: bold accent-color block slides in with overshoot, condensed name + mono role"
---
-`lower-third` `overlay` `podcast` `interview` `bold`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Lower Third β Color Block block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add lt-color-block
```
-## Details
+That writes one file: `compositions/lt-color-block.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4.8s |
+## Add it to your video
-**Installed files**
+It runs for 4.8 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `lt-color-block.html` | `compositions/lt-color-block.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `lower-third` `overlay` `podcast` `interview` `bold`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/lt-dark-card.mdx b/docs/catalog/blocks/lt-dark-card.mdx
index 6bc382841d..0d81ee1428 100644
--- a/docs/catalog/blocks/lt-dark-card.mdx
+++ b/docs/catalog/blocks/lt-dark-card.mdx
@@ -3,49 +3,39 @@ title: "Lower Third β Dark Card"
description: "Charcoal card lower third for bright footage: name, drawn accent underline, role; slide-up entrance"
---
-`lower-third` `overlay` `podcast` `interview` `dark`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Lower Third β Dark Card block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add lt-dark-card
```
-## Details
+That writes one file: `compositions/lt-dark-card.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4.8s |
+## Add it to your video
-**Installed files**
+It runs for 4.8 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `lt-dark-card.html` | `compositions/lt-dark-card.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `lower-third` `overlay` `podcast` `interview` `dark`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/lt-kicker-name.mdx b/docs/catalog/blocks/lt-kicker-name.mdx
index a6af604c41..9f9bb30d39 100644
--- a/docs/catalog/blocks/lt-kicker-name.mdx
+++ b/docs/catalog/blocks/lt-kicker-name.mdx
@@ -3,49 +3,39 @@ title: "Lower Third β Kicker Name"
description: "Cardless lower third with an accent eyebrow/kicker tag, heavy name, and a drawn baseline; for footage"
---
-`lower-third` `overlay` `podcast` `interview` `bold`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Lower Third β Kicker Name block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add lt-kicker-name
```
-## Details
+That writes one file: `compositions/lt-kicker-name.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4.8s |
+## Add it to your video
-**Installed files**
+It runs for 4.8 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `lt-kicker-name.html` | `compositions/lt-kicker-name.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `lower-third` `overlay` `podcast` `interview` `bold`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/lt-mask-reveal.mdx b/docs/catalog/blocks/lt-mask-reveal.mdx
index abf98daa12..d7e5deea32 100644
--- a/docs/catalog/blocks/lt-mask-reveal.mdx
+++ b/docs/catalog/blocks/lt-mask-reveal.mdx
@@ -3,49 +3,39 @@ title: "Lower Third β Mask Reveal"
description: "Cardless lower third: an accent sweep crosses and clip-path-reveals a heavy name, role fades up; for footage"
---
-`lower-third` `overlay` `podcast` `interview` `bold`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Lower Third β Mask Reveal block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add lt-mask-reveal
```
-## Details
+That writes one file: `compositions/lt-mask-reveal.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4.8s |
+## Add it to your video
-**Installed files**
+It runs for 4.8 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `lt-mask-reveal.html` | `compositions/lt-mask-reveal.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `lower-third` `overlay` `podcast` `interview` `bold`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/lt-side-rule.mdx b/docs/catalog/blocks/lt-side-rule.mdx
index 5a775128e8..673f3fcbdb 100644
--- a/docs/catalog/blocks/lt-side-rule.mdx
+++ b/docs/catalog/blocks/lt-side-rule.mdx
@@ -3,49 +3,39 @@ title: "Lower Third β Side Rule"
description: "Cardless lower third with a vertical accent bar; condensed display name + mono role, text-shadowed for footage"
---
-`lower-third` `overlay` `podcast` `interview` `minimal`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Lower Third β Side Rule block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add lt-side-rule
```
-## Details
+That writes one file: `compositions/lt-side-rule.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4.8s |
+## Add it to your video
-**Installed files**
+It runs for 4.8 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `lt-side-rule.html` | `compositions/lt-side-rule.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `lower-third` `overlay` `podcast` `interview` `minimal`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/lt-soft-pill.mdx b/docs/catalog/blocks/lt-soft-pill.mdx
index 406c9f8daf..eb42446e5d 100644
--- a/docs/catalog/blocks/lt-soft-pill.mdx
+++ b/docs/catalog/blocks/lt-soft-pill.mdx
@@ -3,49 +3,39 @@ title: "Lower Third β Soft Pill"
description: "Rounded white pill lower third for podcasts/interviews: status dot, name + role, scale-pop entrance"
---
-`lower-third` `overlay` `podcast` `interview` `minimal`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Lower Third β Soft Pill block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add lt-soft-pill
```
-## Details
+That writes one file: `compositions/lt-soft-pill.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4.8s |
+## Add it to your video
-**Installed files**
+It runs for 4.8 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `lt-soft-pill.html` | `compositions/lt-soft-pill.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `lower-third` `overlay` `podcast` `interview` `minimal`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/lt-stack-bars.mdx b/docs/catalog/blocks/lt-stack-bars.mdx
index 21a4b48b53..1067d2be7b 100644
--- a/docs/catalog/blocks/lt-stack-bars.mdx
+++ b/docs/catalog/blocks/lt-stack-bars.mdx
@@ -3,49 +3,39 @@ title: "Lower Third β Stack Bars"
description: "Two stacked bars: a dark name bar wipes from the left, an accent role bar wipes from the right"
---
-`lower-third` `overlay` `podcast` `interview` `bold`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Lower Third β Stack Bars block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add lt-stack-bars
```
-## Details
+That writes one file: `compositions/lt-stack-bars.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4.8s |
+## Add it to your video
-**Installed files**
+It runs for 4.8 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `lt-stack-bars.html` | `compositions/lt-stack-bars.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `lower-third` `overlay` `podcast` `interview` `bold`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/macos-notification.mdx b/docs/catalog/blocks/macos-notification.mdx
index 58508174f0..fd5fa2810c 100644
--- a/docs/catalog/blocks/macos-notification.mdx
+++ b/docs/catalog/blocks/macos-notification.mdx
@@ -3,49 +3,39 @@ title: "macOS Notification"
description: "Animated macOS-style notification banner with app icon and message"
---
-`social` `overlay` `notification`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the macOS Notification block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add macos-notification
```
-## Details
+That writes one file: `compositions/macos-notification.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 5s |
+## Add it to your video
-**Installed files**
+It runs for 5 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `macos-notification.html` | `compositions/macos-notification.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `social` `overlay` `notification`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/macos-tahoe-liquid-glass.mdx b/docs/catalog/blocks/macos-tahoe-liquid-glass.mdx
index 51f4b34530..284995acaf 100644
--- a/docs/catalog/blocks/macos-tahoe-liquid-glass.mdx
+++ b/docs/catalog/blocks/macos-tahoe-liquid-glass.mdx
@@ -3,71 +3,45 @@ title: "macOS Tahoe Liquid Glass Desktop"
description: "3D MacBook with a macOS Tahoe-style desktop, glass menu bar, Finder window, dock, and cinematic device camera move."
---
-`html-in-canvas` `3d` `macos` `tahoe` `gltf`
-
-
-**Requires Chrome flag.** Enable `chrome://flags/#canvas-draw-element` for live preview. Rendering via CLI enables the flag automatically. [Learn more](/guides/html-in-canvas).
-
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the macOS Tahoe Liquid Glass Desktop block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add macos-tahoe-liquid-glass
```
-## Details
+That writes `compositions/macos-tahoe-liquid-glass.html`, plus 18 supporting files under `models/`, `assets/wallpapers/`, and `assets/icons/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 15s |
+
+ Live preview needs the `chrome://flags/#canvas-draw-element` flag switched on.
+ Rendering from the CLI switches it on for you. [How it
+ works](/guides/html-in-canvas)
+
-**Installed files**
+## Add it to your video
-| File | Target | Type |
-| --- | --- | --- |
-| `macos-tahoe-liquid-glass.html` | `compositions/macos-tahoe-liquid-glass.html` | hyperframes:composition |
-| `models/macbook.glb` | `models/macbook.glb` | hyperframes:asset |
-| `assets/wallpapers/golden-gate-bridge-san-francisco-5k-0g.jpg` | `assets/wallpapers/golden-gate-bridge-san-francisco-5k-0g.jpg` | hyperframes:asset |
-| `assets/icons/finder.png` | `assets/icons/finder.png` | hyperframes:asset |
-| `assets/icons/safari.jpg` | `assets/icons/safari.jpg` | hyperframes:asset |
-| `assets/icons/mail.jpg` | `assets/icons/mail.jpg` | hyperframes:asset |
-| `assets/icons/calendar.jpg` | `assets/icons/calendar.jpg` | hyperframes:asset |
-| `assets/icons/photos.jpg` | `assets/icons/photos.jpg` | hyperframes:asset |
-| `assets/icons/messages.jpg` | `assets/icons/messages.jpg` | hyperframes:asset |
-| `assets/icons/toast-messages.jpg` | `assets/icons/toast-messages.jpg` | hyperframes:asset |
-| `assets/icons/music.jpg` | `assets/icons/music.jpg` | hyperframes:asset |
-| `assets/icons/brave.jpg` | `assets/icons/brave.jpg` | hyperframes:asset |
-| `assets/icons/slack.jpg` | `assets/icons/slack.jpg` | hyperframes:asset |
-| `assets/icons/files.jpg` | `assets/icons/files.jpg` | hyperframes:asset |
-| `assets/icons/dock-finder.png` | `assets/icons/dock-finder.png` | hyperframes:asset |
-| `assets/icons/dock-safari.jpg` | `assets/icons/dock-safari.jpg` | hyperframes:asset |
-| `assets/icons/dock-mail.jpg` | `assets/icons/dock-mail.jpg` | hyperframes:asset |
-| `assets/icons/dock-photos.jpg` | `assets/icons/dock-photos.jpg` | hyperframes:asset |
-| `assets/icons/dock-music.jpg` | `assets/icons/dock-music.jpg` | hyperframes:asset |
+It runs for 15 seconds at 1920Γ1080. Paste this into your composition:
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `html-in-canvas` `3d` `macos` `tahoe` `gltf`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/mk-background.mdx b/docs/catalog/blocks/mk-background.mdx
index 101459f7f2..f9f1d9f689 100644
--- a/docs/catalog/blocks/mk-background.mdx
+++ b/docs/catalog/blocks/mk-background.mdx
@@ -3,49 +3,39 @@ title: "Minimal Gradient Background"
description: "Procedural soft-blob gradient backdrop in a minimalist presentation style: two radial blobs drifting over a base color, with an animatable rounded-card bar mask and optional frosted-glass mode"
---
-`background` `gradient` `minimal` `professional` `presentation`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Minimal Gradient Background block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add mk-background
```
-## Details
+That writes one file: `compositions/mk-background.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 10s |
+## Add it to your video
-**Installed files**
+It runs for 10 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `mk-background.html` | `compositions/mk-background.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `background` `gradient` `minimal` `professional` `presentation`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/mk-callout-highlight.mdx b/docs/catalog/blocks/mk-callout-highlight.mdx
index cd007cdcbb..49a91731cc 100644
--- a/docs/catalog/blocks/mk-callout-highlight.mdx
+++ b/docs/catalog/blocks/mk-callout-highlight.mdx
@@ -3,49 +3,39 @@ title: "Word-Sweep Highlight"
description: "A sentence whose word-by-word emphasis is driven by a single scalar β tween it to sync the highlight with a voiceover"
---
-`typography` `karaoke` `captions` `minimal`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Word-Sweep Highlight block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add mk-callout-highlight
```
-## Details
+That writes one file: `compositions/mk-callout-highlight.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 8s |
+## Add it to your video
-**Installed files**
+It runs for 8 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `mk-callout-highlight.html` | `compositions/mk-callout-highlight.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `typography` `karaoke` `captions` `minimal`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/mk-clone-wall-transition.mdx b/docs/catalog/blocks/mk-clone-wall-transition.mdx
index 2e53f6585c..bc921077eb 100644
--- a/docs/catalog/blocks/mk-clone-wall-transition.mdx
+++ b/docs/catalog/blocks/mk-clone-wall-transition.mdx
@@ -3,49 +3,39 @@ title: "Text Clone Wall Transition"
description: "Overlay transition: a tiled word wall covers the frame, inverts via difference blending, and clears β hard-cut the content beneath while covered"
---
-`transition` `typography` `wipe`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Text Clone Wall Transition block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add mk-clone-wall-transition
```
-## Details
+That writes one file: `compositions/mk-clone-wall-transition.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 2.4s |
+## Add it to your video
-**Installed files**
+It runs for 2.4 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `mk-clone-wall-transition.html` | `compositions/mk-clone-wall-transition.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `typography` `wipe`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/mk-line-graph.mdx b/docs/catalog/blocks/mk-line-graph.mdx
index 0ce436deb1..8c30ca0701 100644
--- a/docs/catalog/blocks/mk-line-graph.mdx
+++ b/docs/catalog/blocks/mk-line-graph.mdx
@@ -3,49 +3,39 @@ title: "Minimal Line Graph"
description: "One or two SVG series draw on with dots popping and value labels riding the draw front; dim baseline axis, x-labels, color-dot legend"
---
-`data-viz` `chart` `graph` `minimal`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Minimal Line Graph block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add mk-line-graph
```
-## Details
+That writes one file: `compositions/mk-line-graph.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 7s |
+## Add it to your video
-**Installed files**
+It runs for 7 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `mk-line-graph.html` | `compositions/mk-line-graph.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `data-viz` `chart` `graph` `minimal`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/mk-placeholder-grid.mdx b/docs/catalog/blocks/mk-placeholder-grid.mdx
index a743072f2d..57773aa67a 100644
--- a/docs/catalog/blocks/mk-placeholder-grid.mdx
+++ b/docs/catalog/blocks/mk-placeholder-grid.mdx
@@ -3,49 +3,39 @@ title: "Rounded Media Grid"
description: "N-up rounded-corner media grid (2-up, 3-up, 4-up, 3x2, hero plus two): per-cell inside-scale framing, staggered box-in entrance, slow settle"
---
-`placeholder` `media` `grid` `minimal`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Rounded Media Grid block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add mk-placeholder-grid
```
-## Details
+That writes one file: `compositions/mk-placeholder-grid.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 8s |
+## Add it to your video
-**Installed files**
+It runs for 8 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `mk-placeholder-grid.html` | `compositions/mk-placeholder-grid.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `placeholder` `media` `grid` `minimal`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/mk-progress-stat.mdx b/docs/catalog/blocks/mk-progress-stat.mdx
index ac7bc07a6e..ef713b4df4 100644
--- a/docs/catalog/blocks/mk-progress-stat.mdx
+++ b/docs/catalog/blocks/mk-progress-stat.mdx
@@ -3,49 +3,39 @@ title: "Count-Up Stat Card"
description: "Big-numeral statistic with count-up, label, thin progress track filling to value/max, and caption; light and dark schemes"
---
-`data-viz` `stat` `minimal`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Count-Up Stat Card block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add mk-progress-stat
```
-## Details
+That writes one file: `compositions/mk-progress-stat.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 7s |
+## Add it to your video
-**Installed files**
+It runs for 7 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `mk-progress-stat.html` | `compositions/mk-progress-stat.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `data-viz` `stat` `minimal`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/mk-specs-list.mdx b/docs/catalog/blocks/mk-specs-list.mdx
index e5624a085c..5be540bb56 100644
--- a/docs/catalog/blocks/mk-specs-list.mdx
+++ b/docs/catalog/blocks/mk-specs-list.mdx
@@ -3,49 +3,39 @@ title: "Specs Checklist"
description: "Left-aligned specs/traits checklist over footage or a board: rows slide in staggered with an accent underline sweep; light and dark schemes"
---
-`data-viz` `list` `minimal` `professional`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Specs Checklist block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add mk-specs-list
```
-## Details
+That writes one file: `compositions/mk-specs-list.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 8s |
+## Add it to your video
-**Installed files**
+It runs for 8 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `mk-specs-list.html` | `compositions/mk-specs-list.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `data-viz` `list` `minimal` `professional`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/news-ticker.mdx b/docs/catalog/blocks/news-ticker.mdx
index 96ff4493c9..df689c280c 100644
--- a/docs/catalog/blocks/news-ticker.mdx
+++ b/docs/catalog/blocks/news-ticker.mdx
@@ -3,49 +3,39 @@ title: "News Ticker"
description: "Premium broadcast-style lower-third ticker with live label, headline ribbon, and scrolling news crawl."
---
-`lower-third` `overlay` `news` `ticker`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the News Ticker block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add news-ticker
```
-## Details
+That writes one file: `compositions/news-ticker.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 7s |
+## Add it to your video
-**Installed files**
+It runs for 7 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `news-ticker.html` | `compositions/news-ticker.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `lower-third` `overlay` `news` `ticker`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/north-korea-locked-down.mdx b/docs/catalog/blocks/north-korea-locked-down.mdx
index 2145aa075a..e9c0d95ef8 100644
--- a/docs/catalog/blocks/north-korea-locked-down.mdx
+++ b/docs/catalog/blocks/north-korea-locked-down.mdx
@@ -3,57 +3,48 @@ title: "North Korea Locked Down"
description: "Realistic map zoom into North Korea with a red scribble circle, locked-down pop-up label, and reddish editorial wash."
---
-`showcase` `map` `annotation` `youtube` `kinetic`
+
+
+## Install
+
+```bash Terminal
+npx hyperframes add north-korea-locked-down
+```
+
+That writes `compositions/north-korea-locked-down.html`, plus 1 supporting file under `assets/`.
+
+## Add it to your video
+
+It runs for 7 seconds at 1920Γ1080. Paste this into your composition:
+
+```html index.html
+
+```
+
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `showcase` `map` `annotation` `youtube` `kinetic`.
Created by [Stronkter](https://x.com/Stronkter).
-## Source Prompt
+
```text
use π·HyperFrames by HeyGen and Image Gen if you need it for assets or like png images of assets without backround to make a youtube style camera moving in out and other things that are in youtube videos, to make a video of a map zooms in on north korea and a scribble style circle circles the country and a text pops up above it saying locked down when the text apears the video turns a bit redish make the video 7 seconds long id like the map to look realistic and accurate to real lfe
```
-
-
-## Add it to a project
-
-### Ask your agent
-
-```text
-Add the North Korea Locked Down block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
-npx hyperframes add north-korea-locked-down
-```
-
-## Details
-
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 7s |
-
-**Installed files**
-
-| File | Target | Type |
-| --- | --- | --- |
-| `north-korea-locked-down.html` | `compositions/north-korea-locked-down.html` | hyperframes:composition |
-| `assets/korea-map.png` | `assets/korea-map.png` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
-```
+
## Related topics
diff --git a/docs/catalog/blocks/nyc-paris-flight.mdx b/docs/catalog/blocks/nyc-paris-flight.mdx
index b26fcec17c..7f09281046 100644
--- a/docs/catalog/blocks/nyc-paris-flight.mdx
+++ b/docs/catalog/blocks/nyc-paris-flight.mdx
@@ -3,58 +3,48 @@ title: "NYC Paris Flight"
description: "Apple-style realistic map animation with a plane flying from New York to Paris, marker circle, landing pop, and sound effects."
---
-`showcase` `travel` `map` `youtube` `sfx`
+
+
+## Install
+
+```bash Terminal
+npx hyperframes add nyc-paris-flight
+```
+
+That writes `compositions/nyc-paris-flight.html`, plus 2 supporting files under `assets/`.
+
+## Add it to your video
+
+It runs for 6 seconds at 1920Γ1080. Paste this into your composition:
+
+```html index.html
+
+```
+
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `showcase` `travel` `map` `youtube` `sfx`.
Created by [Stronkter](https://x.com/Stronkter).
-## Source Prompt
+
```text
π·HyperFrames by HeyGen Make a six-second Apple-style font bold video of a plane going from New York to Paris. A map animation, and then it shows the plane going from New York to Paris. Make the fonts Apple-style bold and make the map actual realistic, actually realistic. Before it lands in Paris, do a doodle circle in red around Paris, and then it lands in the doodle circle, and the video basically cuts to a white screen at the end. Also add sound effects for everything as well. Every nice motion, every the plane for pop-ups, bubble, pop-up effect, everything you want.
```
-
-
-## Add it to a project
-
-### Ask your agent
-
-```text
-Add the NYC Paris Flight block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
-npx hyperframes add nyc-paris-flight
-```
-
-## Details
-
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 6s |
-
-**Installed files**
-
-| File | Target | Type |
-| --- | --- | --- |
-| `nyc-paris-flight.html` | `compositions/nyc-paris-flight.html` | hyperframes:composition |
-| `assets/map-nyc-paris.png` | `assets/map-nyc-paris.png` | hyperframes:asset |
-| `assets/sfx-mix.wav` | `assets/sfx-mix.wav` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
-```
+
## Related topics
diff --git a/docs/catalog/blocks/organic-light-leak-overlay.mdx b/docs/catalog/blocks/organic-light-leak-overlay.mdx
index 2bf876eec8..47ddc42ddd 100644
--- a/docs/catalog/blocks/organic-light-leak-overlay.mdx
+++ b/docs/catalog/blocks/organic-light-leak-overlay.mdx
@@ -3,49 +3,39 @@ title: "Organic Light Leak Overlay"
description: "Finite CSS light-leak overlay for memory beats and motivated transitions"
---
-`light-leak` `film` `memory` `transition` `overlay` `media-treatment-overlay`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Organic Light Leak Overlay block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add organic-light-leak-overlay
```
-## Details
+That writes one file: `compositions/organic-light-leak-overlay.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4s |
+## Add it to your video
-**Installed files**
+It runs for 4 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `organic-light-leak-overlay.html` | `compositions/organic-light-leak-overlay.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `light-leak` `film` `memory` `transition` `overlay` `media-treatment-overlay`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/reddit-post.mdx b/docs/catalog/blocks/reddit-post.mdx
index 9fbd558156..cf13693acb 100644
--- a/docs/catalog/blocks/reddit-post.mdx
+++ b/docs/catalog/blocks/reddit-post.mdx
@@ -3,49 +3,39 @@ title: "Reddit Post Card"
description: "Animated Reddit post card overlay with upvotes and comments"
---
-`social` `overlay` `reddit`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Reddit Post Card block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add reddit-post
```
-## Details
+That writes one file: `compositions/reddit-post.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 5s |
+## Add it to your video
-**Installed files**
+It runs for 5 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `reddit-post.html` | `compositions/reddit-post.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `social` `overlay` `reddit`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/ridged-burn.mdx b/docs/catalog/blocks/ridged-burn.mdx
index 4246e3f336..b37067644e 100644
--- a/docs/catalog/blocks/ridged-burn.mdx
+++ b/docs/catalog/blocks/ridged-burn.mdx
@@ -3,49 +3,39 @@ title: "Ridged Burn"
description: "Shader transition with ridged turbulence burn effect"
---
-`transition` `shader`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Ridged Burn block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add ridged-burn
```
-## Details
+That writes one file: `compositions/ridged-burn.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4s |
+## Add it to your video
-**Installed files**
+It runs for 4 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `ridged-burn.html` | `compositions/ridged-burn.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `shader`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/ripple-waves.mdx b/docs/catalog/blocks/ripple-waves.mdx
index a6fd37982e..7617bc94e8 100644
--- a/docs/catalog/blocks/ripple-waves.mdx
+++ b/docs/catalog/blocks/ripple-waves.mdx
@@ -3,49 +3,39 @@ title: "Ripple Waves"
description: "Shader transition with concentric ripple wave distortion"
---
-`transition` `shader`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Ripple Waves block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add ripple-waves
```
-## Details
+That writes one file: `compositions/ripple-waves.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4s |
+## Add it to your video
-**Installed files**
+It runs for 4 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `ripple-waves.html` | `compositions/ripple-waves.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `shader`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/sdf-iris.mdx b/docs/catalog/blocks/sdf-iris.mdx
index 18da36e53a..0c5620978f 100644
--- a/docs/catalog/blocks/sdf-iris.mdx
+++ b/docs/catalog/blocks/sdf-iris.mdx
@@ -3,49 +3,39 @@ title: "SDF Iris"
description: "Shader transition with signed distance field iris reveal"
---
-`transition` `shader`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the SDF Iris block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add sdf-iris
```
-## Details
+That writes one file: `compositions/sdf-iris.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4s |
+## Add it to your video
-**Installed files**
+It runs for 4 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `sdf-iris.html` | `compositions/sdf-iris.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `shader`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/spain-map.mdx b/docs/catalog/blocks/spain-map.mdx
index 7433979264..138c9b9201 100644
--- a/docs/catalog/blocks/spain-map.mdx
+++ b/docs/catalog/blocks/spain-map.mdx
@@ -3,49 +3,39 @@ title: "Spain Map"
description: "Animated Spain choropleth by autonomous community with staggered reveals and gradient legend β D3 conic conformal projection"
---
-`data` `map` `geography` `spain` `europe` `choropleth`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Spain Map block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add spain-map
```
-## Details
+That writes one file: `compositions/spain-map.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 12s |
+## Add it to your video
-**Installed files**
+It runs for 12 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `spain-map.html` | `compositions/spain-map.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `data` `map` `geography` `spain` `europe` `choropleth`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/spotify-card.mdx b/docs/catalog/blocks/spotify-card.mdx
index 196a6c236f..5375a0d0cd 100644
--- a/docs/catalog/blocks/spotify-card.mdx
+++ b/docs/catalog/blocks/spotify-card.mdx
@@ -3,49 +3,39 @@ title: "Spotify Now Playing"
description: "Animated Spotify now-playing card with album art and progress bar"
---
-`social` `overlay` `spotify`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Spotify Now Playing block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add spotify-card
```
-## Details
+That writes one file: `compositions/spotify-card.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1080Γ1920 |
-| Duration | 5s |
+## Add it to your video
-**Installed files**
+It runs for 5 seconds at 1080Γ1920. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `spotify-card.html` | `compositions/spotify-card.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `social` `overlay` `spotify`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/swirl-vortex.mdx b/docs/catalog/blocks/swirl-vortex.mdx
index 9846864198..0b3a669e51 100644
--- a/docs/catalog/blocks/swirl-vortex.mdx
+++ b/docs/catalog/blocks/swirl-vortex.mdx
@@ -3,49 +3,39 @@ title: "Swirl Vortex"
description: "Shader transition with swirling vortex distortion"
---
-`transition` `shader`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Swirl Vortex block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add swirl-vortex
```
-## Details
+That writes one file: `compositions/swirl-vortex.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4s |
+## Add it to your video
-**Installed files**
+It runs for 4 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `swirl-vortex.html` | `compositions/swirl-vortex.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `shader`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/thermal-distortion.mdx b/docs/catalog/blocks/thermal-distortion.mdx
index a478d2cda9..5578803506 100644
--- a/docs/catalog/blocks/thermal-distortion.mdx
+++ b/docs/catalog/blocks/thermal-distortion.mdx
@@ -3,49 +3,39 @@ title: "Thermal Distortion"
description: "Shader transition with heat haze thermal distortion"
---
-`transition` `shader`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Thermal Distortion block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add thermal-distortion
```
-## Details
+That writes one file: `compositions/thermal-distortion.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4s |
+## Add it to your video
-**Installed files**
+It runs for 4 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `thermal-distortion.html` | `compositions/thermal-distortion.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `shader`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/tiktok-follow.mdx b/docs/catalog/blocks/tiktok-follow.mdx
index 510cf9c1d9..6224367fe0 100644
--- a/docs/catalog/blocks/tiktok-follow.mdx
+++ b/docs/catalog/blocks/tiktok-follow.mdx
@@ -3,50 +3,39 @@ title: "TikTok Follow"
description: "Animated TikTok follow overlay with profile card and follow button"
---
-`social` `overlay` `tiktok`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the TikTok Follow block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add tiktok-follow
```
-## Details
+That writes `compositions/tiktok-follow.html`, plus 1 supporting file under `assets/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1080Γ1920 |
-| Duration | 4.5s |
+## Add it to your video
-**Installed files**
+It runs for 4.5 seconds at 1080Γ1920. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `tiktok-follow.html` | `compositions/tiktok-follow.html` | hyperframes:composition |
-| `assets/avatar.jpg` | `assets/avatar.jpg` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `social` `overlay` `tiktok`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/transitions-3d.mdx b/docs/catalog/blocks/transitions-3d.mdx
index 8867645081..554fd608ed 100644
--- a/docs/catalog/blocks/transitions-3d.mdx
+++ b/docs/catalog/blocks/transitions-3d.mdx
@@ -3,49 +3,39 @@ title: "3D Transitions"
description: "Showcase of 3D perspective flip and rotate transitions"
---
-`transition` `showcase`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the 3D Transitions block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add transitions-3d
```
-## Details
+That writes one file: `compositions/transitions-3d.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 11s |
+## Add it to your video
-**Installed files**
+It runs for 11 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `transitions-3d.html` | `compositions/transitions-3d.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `showcase`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/transitions-blur.mdx b/docs/catalog/blocks/transitions-blur.mdx
index 4ade0819ad..7da3aa55ab 100644
--- a/docs/catalog/blocks/transitions-blur.mdx
+++ b/docs/catalog/blocks/transitions-blur.mdx
@@ -3,49 +3,39 @@ title: "Blur Transitions"
description: "Showcase of blur-based transitions between scenes"
---
-`transition` `showcase`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Blur Transitions block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add transitions-blur
```
-## Details
+That writes one file: `compositions/transitions-blur.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 20s |
+## Add it to your video
-**Installed files**
+It runs for 20 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `transitions-blur.html` | `compositions/transitions-blur.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `showcase`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/transitions-cover.mdx b/docs/catalog/blocks/transitions-cover.mdx
index f53ef285aa..81055e9d43 100644
--- a/docs/catalog/blocks/transitions-cover.mdx
+++ b/docs/catalog/blocks/transitions-cover.mdx
@@ -3,49 +3,39 @@ title: "Cover Transitions"
description: "Showcase of cover/uncover slide transitions"
---
-`transition` `showcase`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Cover Transitions block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add transitions-cover
```
-## Details
+That writes one file: `compositions/transitions-cover.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 21s |
+## Add it to your video
-**Installed files**
+It runs for 21 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `transitions-cover.html` | `compositions/transitions-cover.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `showcase`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/transitions-destruction.mdx b/docs/catalog/blocks/transitions-destruction.mdx
index 12e7bc6b11..1834f8a1b5 100644
--- a/docs/catalog/blocks/transitions-destruction.mdx
+++ b/docs/catalog/blocks/transitions-destruction.mdx
@@ -3,49 +3,39 @@ title: "Destruction Transitions"
description: "Showcase of destructive break-apart transitions"
---
-`transition` `showcase`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Destruction Transitions block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add transitions-destruction
```
-## Details
+That writes one file: `compositions/transitions-destruction.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 14s |
+## Add it to your video
-**Installed files**
+It runs for 14 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `transitions-destruction.html` | `compositions/transitions-destruction.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `showcase`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/transitions-dissolve.mdx b/docs/catalog/blocks/transitions-dissolve.mdx
index 023f8a5c74..4d44438410 100644
--- a/docs/catalog/blocks/transitions-dissolve.mdx
+++ b/docs/catalog/blocks/transitions-dissolve.mdx
@@ -3,49 +3,39 @@ title: "Dissolve Transitions"
description: "Showcase of dissolve and fade transitions"
---
-`transition` `showcase`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Dissolve Transitions block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add transitions-dissolve
```
-## Details
+That writes one file: `compositions/transitions-dissolve.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 24s |
+## Add it to your video
-**Installed files**
+It runs for 24 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `transitions-dissolve.html` | `compositions/transitions-dissolve.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `showcase`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/transitions-distortion.mdx b/docs/catalog/blocks/transitions-distortion.mdx
index a32e29bf35..8dc4392740 100644
--- a/docs/catalog/blocks/transitions-distortion.mdx
+++ b/docs/catalog/blocks/transitions-distortion.mdx
@@ -3,49 +3,39 @@ title: "Distortion Transitions"
description: "Showcase of warp and distortion transitions"
---
-`transition` `showcase`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Distortion Transitions block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add transitions-distortion
```
-## Details
+That writes one file: `compositions/transitions-distortion.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 21s |
+## Add it to your video
-**Installed files**
+It runs for 21 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `transitions-distortion.html` | `compositions/transitions-distortion.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `showcase`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/transitions-grid.mdx b/docs/catalog/blocks/transitions-grid.mdx
index 6056825c6a..6557ee574e 100644
--- a/docs/catalog/blocks/transitions-grid.mdx
+++ b/docs/catalog/blocks/transitions-grid.mdx
@@ -3,49 +3,39 @@ title: "Grid Transitions"
description: "Showcase of grid-based tile transitions"
---
-`transition` `showcase`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Grid Transitions block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add transitions-grid
```
-## Details
+That writes one file: `compositions/transitions-grid.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 11s |
+## Add it to your video
-**Installed files**
+It runs for 11 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `transitions-grid.html` | `compositions/transitions-grid.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `showcase`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/transitions-light.mdx b/docs/catalog/blocks/transitions-light.mdx
index 7f16fd9946..20c7d15593 100644
--- a/docs/catalog/blocks/transitions-light.mdx
+++ b/docs/catalog/blocks/transitions-light.mdx
@@ -3,49 +3,39 @@ title: "Light Transitions"
description: "Showcase of light-based glow and flash transitions"
---
-`transition` `showcase`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Light Transitions block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add transitions-light
```
-## Details
+That writes one file: `compositions/transitions-light.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 21s |
+## Add it to your video
-**Installed files**
+It runs for 21 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `transitions-light.html` | `compositions/transitions-light.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `showcase`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/transitions-mechanical.mdx b/docs/catalog/blocks/transitions-mechanical.mdx
index b71df6a60e..30f199702f 100644
--- a/docs/catalog/blocks/transitions-mechanical.mdx
+++ b/docs/catalog/blocks/transitions-mechanical.mdx
@@ -3,49 +3,39 @@ title: "Mechanical Transitions"
description: "Showcase of mechanical shutter and iris transitions"
---
-`transition` `showcase`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Mechanical Transitions block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add transitions-mechanical
```
-## Details
+That writes one file: `compositions/transitions-mechanical.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 15s |
+## Add it to your video
-**Installed files**
+It runs for 15 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `transitions-mechanical.html` | `compositions/transitions-mechanical.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `showcase`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/transitions-other.mdx b/docs/catalog/blocks/transitions-other.mdx
index a1f871fae6..6f3b9a1675 100644
--- a/docs/catalog/blocks/transitions-other.mdx
+++ b/docs/catalog/blocks/transitions-other.mdx
@@ -3,49 +3,39 @@ title: "Other Transitions"
description: "Showcase of miscellaneous creative transitions"
---
-`transition` `showcase`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Other Transitions block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add transitions-other
```
-## Details
+That writes one file: `compositions/transitions-other.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 20s |
+## Add it to your video
-**Installed files**
+It runs for 20 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `transitions-other.html` | `compositions/transitions-other.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `showcase`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/transitions-push.mdx b/docs/catalog/blocks/transitions-push.mdx
index 6bc7bb5938..89f828d5a0 100644
--- a/docs/catalog/blocks/transitions-push.mdx
+++ b/docs/catalog/blocks/transitions-push.mdx
@@ -3,49 +3,39 @@ title: "Push Transitions"
description: "Showcase of push and slide transitions"
---
-`transition` `showcase`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Push Transitions block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add transitions-push
```
-## Details
+That writes one file: `compositions/transitions-push.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 24s |
+## Add it to your video
-**Installed files**
+It runs for 24 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `transitions-push.html` | `compositions/transitions-push.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `showcase`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/transitions-radial.mdx b/docs/catalog/blocks/transitions-radial.mdx
index c307b81c66..fcd7f1727a 100644
--- a/docs/catalog/blocks/transitions-radial.mdx
+++ b/docs/catalog/blocks/transitions-radial.mdx
@@ -3,49 +3,39 @@ title: "Radial Transitions"
description: "Showcase of radial wipe and reveal transitions"
---
-`transition` `showcase`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Radial Transitions block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add transitions-radial
```
-## Details
+That writes one file: `compositions/transitions-radial.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 20s |
+## Add it to your video
-**Installed files**
+It runs for 20 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `transitions-radial.html` | `compositions/transitions-radial.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `showcase`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/transitions-scale.mdx b/docs/catalog/blocks/transitions-scale.mdx
index 646ca6efc3..e9d3c44e10 100644
--- a/docs/catalog/blocks/transitions-scale.mdx
+++ b/docs/catalog/blocks/transitions-scale.mdx
@@ -3,49 +3,39 @@ title: "Scale Transitions"
description: "Showcase of scale and zoom transitions"
---
-`transition` `showcase`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Scale Transitions block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add transitions-scale
```
-## Details
+That writes one file: `compositions/transitions-scale.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 15s |
+## Add it to your video
-**Installed files**
+It runs for 15 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `transitions-scale.html` | `compositions/transitions-scale.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `showcase`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/ui-3d-reveal.mdx b/docs/catalog/blocks/ui-3d-reveal.mdx
index 2f878ee6e5..236faf2adc 100644
--- a/docs/catalog/blocks/ui-3d-reveal.mdx
+++ b/docs/catalog/blocks/ui-3d-reveal.mdx
@@ -3,49 +3,39 @@ title: "3D UI Reveal"
description: "Perspective 3D reveal animation for UI elements"
---
-`showcase` `3d` `reveal`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the 3D UI Reveal block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add ui-3d-reveal
```
-## Details
+That writes one file: `compositions/ui-3d-reveal.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 13s |
+## Add it to your video
-**Installed files**
+It runs for 13 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `ui-3d-reveal.html` | `compositions/ui-3d-reveal.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `showcase` `3d` `reveal`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/us-map-bubble.mdx b/docs/catalog/blocks/us-map-bubble.mdx
index 19a930729a..6c9758859b 100644
--- a/docs/catalog/blocks/us-map-bubble.mdx
+++ b/docs/catalog/blocks/us-map-bubble.mdx
@@ -3,49 +3,39 @@ title: "US Bubble Map"
description: "Animated US bubble map with proportional city markers, value callouts, and connection lines β composable with us-map"
---
-`data` `map` `geography` `usa` `bubble` `cities`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the US Bubble Map block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add us-map-bubble
```
-## Details
+That writes one file: `compositions/us-map-bubble.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 12s |
+## Add it to your video
-**Installed files**
+It runs for 12 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `us-map-bubble.html` | `compositions/us-map-bubble.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `data` `map` `geography` `usa` `bubble` `cities`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/us-map-flow.mdx b/docs/catalog/blocks/us-map-flow.mdx
index 2e0a67df48..48bcfca32d 100644
--- a/docs/catalog/blocks/us-map-flow.mdx
+++ b/docs/catalog/blocks/us-map-flow.mdx
@@ -3,49 +3,39 @@ title: "US Flow Map"
description: "Animated connection arcs between US cities over a base map β composable origin-destination flow visualization"
---
-`data` `map` `geography` `usa` `flow` `connections` `arcs`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the US Flow Map block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add us-map-flow
```
-## Details
+That writes one file: `compositions/us-map-flow.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 12s |
+## Add it to your video
-**Installed files**
+It runs for 12 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `us-map-flow.html` | `compositions/us-map-flow.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `data` `map` `geography` `usa` `flow` `connections` `arcs`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/us-map-hex.mdx b/docs/catalog/blocks/us-map-hex.mdx
index 59d35ec7fb..e2b33130c2 100644
--- a/docs/catalog/blocks/us-map-hex.mdx
+++ b/docs/catalog/blocks/us-map-hex.mdx
@@ -3,49 +3,39 @@ title: "US Hex Grid Map"
description: "Animated hexagonal tile grid map β each state as an equal-weight hex with data fill and abbreviation label"
---
-`data` `map` `geography` `usa` `hexgrid` `tilegrid`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the US Hex Grid Map block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add us-map-hex
```
-## Details
+That writes one file: `compositions/us-map-hex.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 10s |
+## Add it to your video
-**Installed files**
+It runs for 10 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `us-map-hex.html` | `compositions/us-map-hex.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `data` `map` `geography` `usa` `hexgrid` `tilegrid`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/us-map.mdx b/docs/catalog/blocks/us-map.mdx
index f55c9390b8..f1ed14ad1b 100644
--- a/docs/catalog/blocks/us-map.mdx
+++ b/docs/catalog/blocks/us-map.mdx
@@ -3,49 +3,39 @@ title: "US Map"
description: "Animated US choropleth map with staggered state reveals, value labels, and gradient legend β pure inline SVG with GSAP"
---
-`data` `map` `geography` `usa` `choropleth`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the US Map block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add us-map
```
-## Details
+That writes one file: `compositions/us-map.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 12s |
+## Add it to your video
-**Installed files**
+It runs for 12 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `us-map.html` | `compositions/us-map.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `data` `map` `geography` `usa` `choropleth`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/vfx-iphone-device.mdx b/docs/catalog/blocks/vfx-iphone-device.mdx
index c639feef57..29deacf74c 100644
--- a/docs/catalog/blocks/vfx-iphone-device.mdx
+++ b/docs/catalog/blocks/vfx-iphone-device.mdx
@@ -3,57 +3,45 @@ title: "iPhone & MacBook 3D Showcase"
description: "Real GLTF iPhone 15 Pro Max and MacBook Pro models with live HTML-in-Canvas screen content, morphing glass lens, product review camera choreography, and 360Β° turntable."
---
-`html-in-canvas` `3d` `device` `iphone` `macbook` `gltf`
-
-
-**Requires Chrome flag.** Enable `chrome://flags/#canvas-draw-element` for live preview. Rendering via CLI enables the flag automatically. [Learn more](/guides/html-in-canvas).
-
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the iPhone & MacBook 3D Showcase block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add vfx-iphone-device
```
-## Details
+That writes `compositions/vfx-iphone-device.html`, plus 4 supporting files under `models/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 15s |
+
+ Live preview needs the `chrome://flags/#canvas-draw-element` flag switched on.
+ Rendering from the CLI switches it on for you. [How it
+ works](/guides/html-in-canvas)
+
-**Installed files**
+## Add it to your video
-| File | Target | Type |
-| --- | --- | --- |
-| `vfx-iphone-device.html` | `compositions/vfx-iphone-device.html` | hyperframes:composition |
-| `models/iphone.glb` | `models/iphone.glb` | asset |
-| `models/macbook.glb` | `models/macbook.glb` | asset |
-| `models/hyperframes-mobile.png` | `models/hyperframes-mobile.png` | asset |
-| `models/hyperframes-desktop.png` | `models/hyperframes-desktop.png` | asset |
+It runs for 15 seconds at 1920Γ1080. Paste this into your composition:
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `html-in-canvas` `3d` `device` `iphone` `macbook` `gltf`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/vfx-liquid-background.mdx b/docs/catalog/blocks/vfx-liquid-background.mdx
index 04a85c81a9..e878a50ed5 100644
--- a/docs/catalog/blocks/vfx-liquid-background.mdx
+++ b/docs/catalog/blocks/vfx-liquid-background.mdx
@@ -3,53 +3,52 @@ title: "Liquid Background"
description: "Organic liquid simulation with vertex displacement on a subdivided plane. HTML content floats above rippling fluid surface with real-time wave dynamics."
---
-`html-in-canvas` `liquid` `webgl` `displacement` `background`
-
-
-**Requires Chrome flag.** Enable `chrome://flags/#canvas-draw-element` for live preview. Rendering via CLI enables the flag automatically. [Learn more](/guides/html-in-canvas).
-
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Liquid Background block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add vfx-liquid-background
```
-## Details
+That writes one file: `compositions/vfx-liquid-background.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 12s |
+
+ Live preview needs the `chrome://flags/#canvas-draw-element` flag switched on.
+ Rendering from the CLI switches it on for you. [How it
+ works](/guides/html-in-canvas)
+
-**Installed files**
+## Add it to your video
-| File | Target | Type |
-| --- | --- | --- |
-| `vfx-liquid-background.html` | `compositions/vfx-liquid-background.html` | hyperframes:composition |
+It runs for 12 seconds at 1920Γ1080. Paste this into your composition:
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+## Change the colors
+
+Set these CSS variables on the block:
+
+- `--bg-color` β Background. Defaults to `#0a0e17`.
+- `--text-color` β Text color. Defaults to `#e2e8f0`.
+
+{/* hf:generated-footer */}
+
+Tagged `html-in-canvas` `liquid` `webgl` `displacement` `background`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/vfx-liquid-glass.mdx b/docs/catalog/blocks/vfx-liquid-glass.mdx
index b1f2642ac5..c486fdc193 100644
--- a/docs/catalog/blocks/vfx-liquid-glass.mdx
+++ b/docs/catalog/blocks/vfx-liquid-glass.mdx
@@ -3,53 +3,52 @@ title: "Liquid Glass"
description: "VFX composition block"
---
-`html-in-canvas` `webgl`
-
-
-**Requires Chrome flag.** Enable `chrome://flags/#canvas-draw-element` for live preview. Rendering via CLI enables the flag automatically. [Learn more](/guides/html-in-canvas).
-
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Liquid Glass block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add vfx-liquid-glass
```
-## Details
+That writes one file: `compositions/vfx-liquid-glass.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 20s |
+
+ Live preview needs the `chrome://flags/#canvas-draw-element` flag switched on.
+ Rendering from the CLI switches it on for you. [How it
+ works](/guides/html-in-canvas)
+
-**Installed files**
+## Add it to your video
-| File | Target | Type |
-| --- | --- | --- |
-| `vfx-liquid-glass.html` | `compositions/vfx-liquid-glass.html` | hyperframes:composition |
+It runs for 20 seconds at 1920Γ1080. Paste this into your composition:
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+## Change the colors
+
+Set these CSS variables on the block:
+
+- `--bg-color` β Background. Defaults to `#030407`.
+- `--accent-color` β Accent. Defaults to `#00d4ff`.
+
+{/* hf:generated-footer */}
+
+Tagged `html-in-canvas` `webgl`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/vfx-magnetic.mdx b/docs/catalog/blocks/vfx-magnetic.mdx
index e10a13ef75..a174e16ad5 100644
--- a/docs/catalog/blocks/vfx-magnetic.mdx
+++ b/docs/catalog/blocks/vfx-magnetic.mdx
@@ -3,53 +3,52 @@ title: "Magnetic"
description: "VFX composition block"
---
-`html-in-canvas` `webgl`
-
-
-**Requires Chrome flag.** Enable `chrome://flags/#canvas-draw-element` for live preview. Rendering via CLI enables the flag automatically. [Learn more](/guides/html-in-canvas).
-
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Magnetic block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add vfx-magnetic
```
-## Details
+That writes one file: `compositions/vfx-magnetic.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 15s |
+
+ Live preview needs the `chrome://flags/#canvas-draw-element` flag switched on.
+ Rendering from the CLI switches it on for you. [How it
+ works](/guides/html-in-canvas)
+
-**Installed files**
+## Add it to your video
-| File | Target | Type |
-| --- | --- | --- |
-| `vfx-magnetic.html` | `compositions/vfx-magnetic.html` | hyperframes:composition |
+It runs for 15 seconds at 1920Γ1080. Paste this into your composition:
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+## Change the colors
+
+Set these CSS variables on the block:
+
+- `--bg-color` β Background. Defaults to `#0c0c0c`.
+- `--text-color` β Text color. Defaults to `#e8e8e8`.
+
+{/* hf:generated-footer */}
+
+Tagged `html-in-canvas` `webgl`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/vfx-portal.mdx b/docs/catalog/blocks/vfx-portal.mdx
index e016e6b9ad..1eed276a73 100644
--- a/docs/catalog/blocks/vfx-portal.mdx
+++ b/docs/catalog/blocks/vfx-portal.mdx
@@ -3,53 +3,52 @@ title: "Portal"
description: "VFX composition block"
---
-`html-in-canvas` `webgl`
-
-
-**Requires Chrome flag.** Enable `chrome://flags/#canvas-draw-element` for live preview. Rendering via CLI enables the flag automatically. [Learn more](/guides/html-in-canvas).
-
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Portal block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add vfx-portal
```
-## Details
+That writes one file: `compositions/vfx-portal.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 10s |
+
+ Live preview needs the `chrome://flags/#canvas-draw-element` flag switched on.
+ Rendering from the CLI switches it on for you. [How it
+ works](/guides/html-in-canvas)
+
-**Installed files**
+## Add it to your video
-| File | Target | Type |
-| --- | --- | --- |
-| `vfx-portal.html` | `compositions/vfx-portal.html` | hyperframes:composition |
+It runs for 10 seconds at 1920Γ1080. Paste this into your composition:
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+## Change the colors
+
+Set these CSS variables on the block:
+
+- `--bg-color` β Background. Defaults to `#000000`.
+- `--portal-color` β Portal color. Defaults to `#fafafa`.
+
+{/* hf:generated-footer */}
+
+Tagged `html-in-canvas` `webgl`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/vfx-shatter.mdx b/docs/catalog/blocks/vfx-shatter.mdx
index a11422be63..7cb1cf546f 100644
--- a/docs/catalog/blocks/vfx-shatter.mdx
+++ b/docs/catalog/blocks/vfx-shatter.mdx
@@ -3,53 +3,45 @@ title: "Shatter"
description: "VFX composition block"
---
-`html-in-canvas` `webgl`
-
-
-**Requires Chrome flag.** Enable `chrome://flags/#canvas-draw-element` for live preview. Rendering via CLI enables the flag automatically. [Learn more](/guides/html-in-canvas).
-
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Shatter block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add vfx-shatter
```
-## Details
+That writes one file: `compositions/vfx-shatter.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 12s |
+
+ Live preview needs the `chrome://flags/#canvas-draw-element` flag switched on.
+ Rendering from the CLI switches it on for you. [How it
+ works](/guides/html-in-canvas)
+
-**Installed files**
+## Add it to your video
-| File | Target | Type |
-| --- | --- | --- |
-| `vfx-shatter.html` | `compositions/vfx-shatter.html` | hyperframes:composition |
+It runs for 12 seconds at 1920Γ1080. Paste this into your composition:
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `html-in-canvas` `webgl`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/vfx-text-cursor.mdx b/docs/catalog/blocks/vfx-text-cursor.mdx
index 19804a7aa0..6d1c8a2b85 100644
--- a/docs/catalog/blocks/vfx-text-cursor.mdx
+++ b/docs/catalog/blocks/vfx-text-cursor.mdx
@@ -3,53 +3,45 @@ title: "VFX Text Cursor"
description: "Dramatic text reveal with cursor glow, chromatic shadow rays, and directional lighting on a black stage. Canvas-based shader post-processing with spectral color edges."
---
-`html-in-canvas` `text` `shader` `cursor` `chromatic`
-
-
-**Requires Chrome flag.** Enable `chrome://flags/#canvas-draw-element` for live preview. Rendering via CLI enables the flag automatically. [Learn more](/guides/html-in-canvas).
-
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the VFX Text Cursor block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add vfx-text-cursor
```
-## Details
+That writes one file: `compositions/vfx-text-cursor.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 8s |
+
+ Live preview needs the `chrome://flags/#canvas-draw-element` flag switched on.
+ Rendering from the CLI switches it on for you. [How it
+ works](/guides/html-in-canvas)
+
-**Installed files**
+## Add it to your video
-| File | Target | Type |
-| --- | --- | --- |
-| `vfx-text-cursor.html` | `compositions/vfx-text-cursor.html` | hyperframes:composition |
+It runs for 8 seconds at 1920Γ1080. Paste this into your composition:
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `html-in-canvas` `text` `shader` `cursor` `chromatic`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/vpn-youtube-spot.mdx b/docs/catalog/blocks/vpn-youtube-spot.mdx
index a180fa80fb..6e1835b89e 100644
--- a/docs/catalog/blocks/vpn-youtube-spot.mdx
+++ b/docs/catalog/blocks/vpn-youtube-spot.mdx
@@ -3,57 +3,48 @@ title: "VPN YouTube Spot"
description: "Snappy Apple-style YouTube insert showing a phone finding and installing a friendly VPN app with sound effects."
---
-`app` `showcase` `youtube` `sfx`
+
+
+## Install
+
+```bash Terminal
+npx hyperframes add vpn-youtube-spot
+```
+
+That writes `compositions/vpn-youtube-spot.html`, plus 1 supporting file under `assets/`.
+
+## Add it to your video
+
+It runs for 7 seconds at 1920Γ1080. Paste this into your composition:
+
+```html index.html
+
+```
+
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `app` `showcase` `youtube` `sfx`.
Created by [Stronkter](https://x.com/Stronkter).
-## Source Prompt
+
```text
HyperFrames by HeyGen make me a 7s video with Apple-style bold font and styling: a phone scrolling in an app store, clicking on a friendly VPN app called VPN, installing it, then snapping down and fading to a white background. Make it snappy and polished for a YouTube insert, with sound effects, 60fps, and 1920x1080.
```
-
-
-## Add it to a project
-
-### Ask your agent
-
-```text
-Add the VPN YouTube Spot block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
-npx hyperframes add vpn-youtube-spot
-```
-
-## Details
-
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 7s |
-
-**Installed files**
-
-| File | Target | Type |
-| --- | --- | --- |
-| `vpn-youtube-spot.html` | `compositions/vpn-youtube-spot.html` | hyperframes:composition |
-| `assets/vpn-sfx.wav` | `assets/vpn-sfx.wav` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
-```
+
## Related topics
diff --git a/docs/catalog/blocks/whip-pan.mdx b/docs/catalog/blocks/whip-pan.mdx
index bcb831ab87..8390feed14 100644
--- a/docs/catalog/blocks/whip-pan.mdx
+++ b/docs/catalog/blocks/whip-pan.mdx
@@ -3,49 +3,39 @@ title: "Whip Pan"
description: "Shader transition simulating a fast camera whip pan"
---
-`transition` `shader`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Whip Pan block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add whip-pan
```
-## Details
+That writes one file: `compositions/whip-pan.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4s |
+## Add it to your video
-**Installed files**
+It runs for 4 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `whip-pan.html` | `compositions/whip-pan.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `transition` `shader`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/world-map.mdx b/docs/catalog/blocks/world-map.mdx
index 4a28426c21..3e52e907ad 100644
--- a/docs/catalog/blocks/world-map.mdx
+++ b/docs/catalog/blocks/world-map.mdx
@@ -3,49 +3,39 @@ title: "World Map"
description: "Animated world choropleth with country-by-country reveal, tooltip labels, and rotating globe inset β D3 Natural Earth projection"
---
-`data` `map` `geography` `world` `choropleth`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the World Map block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add world-map
```
-## Details
+That writes one file: `compositions/world-map.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 14s |
+## Add it to your video
-**Installed files**
+It runs for 14 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `world-map.html` | `compositions/world-map.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `data` `map` `geography` `world` `choropleth`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/x-post.mdx b/docs/catalog/blocks/x-post.mdx
index cc5da347f2..3e07e60718 100644
--- a/docs/catalog/blocks/x-post.mdx
+++ b/docs/catalog/blocks/x-post.mdx
@@ -3,49 +3,39 @@ title: "X Post Card"
description: "Animated X/Twitter post card overlay with engagement metrics"
---
-`social` `overlay` `twitter`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the X Post Card block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add x-post
```
-## Details
+That writes one file: `compositions/x-post.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 5s |
+## Add it to your video
-**Installed files**
+It runs for 5 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `x-post.html` | `compositions/x-post.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `social` `overlay` `twitter`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/yt-comment-card.mdx b/docs/catalog/blocks/yt-comment-card.mdx
index f529fc4e17..281ceefbaa 100644
--- a/docs/catalog/blocks/yt-comment-card.mdx
+++ b/docs/catalog/blocks/yt-comment-card.mdx
@@ -3,49 +3,39 @@ title: "Comment Cards"
description: "Social comments typing on over footage: avatar pop, username and time, per-character typewriter, likes row; image avatars or initials chips"
---
-`social` `comments` `creator` `overlay`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Comment Cards block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add yt-comment-card
```
-## Details
+That writes one file: `compositions/yt-comment-card.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 8s |
+## Add it to your video
-**Installed files**
+It runs for 8 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `yt-comment-card.html` | `compositions/yt-comment-card.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `social` `comments` `creator` `overlay`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/yt-lcd-background.mdx b/docs/catalog/blocks/yt-lcd-background.mdx
index fd5ace98d9..dc0d8c5053 100644
--- a/docs/catalog/blocks/yt-lcd-background.mdx
+++ b/docs/catalog/blocks/yt-lcd-background.mdx
@@ -3,49 +3,39 @@ title: "Scanline Board Background"
description: "Textured paper board: scanlines with slow drift, optional pixel grid, static grain, and display text with a blur-focus entrance and chromatic-fringe title"
---
-`background` `texture` `creator`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Scanline Board Background block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add yt-lcd-background
```
-## Details
+That writes one file: `compositions/yt-lcd-background.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 10s |
+## Add it to your video
-**Installed files**
+It runs for 10 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `yt-lcd-background.html` | `compositions/yt-lcd-background.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `background` `texture` `creator`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/yt-logo-intro.mdx b/docs/catalog/blocks/yt-logo-intro.mdx
index ab26fc32df..31341d3870 100644
--- a/docs/catalog/blocks/yt-logo-intro.mdx
+++ b/docs/catalog/blocks/yt-logo-intro.mdx
@@ -3,49 +3,39 @@ title: "Logo Intro Sequence"
description: "Logo stamp pops on a lined board, a kicker line gives way to the title with an accent arrow chip; seeded line distortion"
---
-`logo` `intro` `creator`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Logo Intro Sequence block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add yt-logo-intro
```
-## Details
+That writes one file: `compositions/yt-logo-intro.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 6s |
+## Add it to your video
-**Installed files**
+It runs for 6 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `yt-logo-intro.html` | `compositions/yt-logo-intro.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `logo` `intro` `creator`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/yt-lower-third.mdx b/docs/catalog/blocks/yt-lower-third.mdx
index 4b017f5c24..8356c59fa5 100644
--- a/docs/catalog/blocks/yt-lower-third.mdx
+++ b/docs/catalog/blocks/yt-lower-third.mdx
@@ -3,50 +3,39 @@ title: "YouTube Lower Third"
description: "Animated YouTube subscribe lower third with avatar and channel info"
---
-`social` `overlay` `youtube`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the YouTube Lower Third block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add yt-lower-third
```
-## Details
+That writes `compositions/yt-lower-third.html`, plus 1 supporting file under `assets/`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 4.5s |
+## Add it to your video
-**Installed files**
+It runs for 4.5 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `yt-lower-third.html` | `compositions/yt-lower-third.html` | hyperframes:composition |
-| `assets/avatar.jpg` | `assets/avatar.jpg` | hyperframes:asset |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `social` `overlay` `youtube`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/yt-prism-title.mdx b/docs/catalog/blocks/yt-prism-title.mdx
index a1c07d0d75..5148a4afbb 100644
--- a/docs/catalog/blocks/yt-prism-title.mdx
+++ b/docs/catalog/blocks/yt-prism-title.mdx
@@ -3,49 +3,39 @@ title: "Chromatic Fringe Title"
description: "Display title on a transparent root: blur-focus entrance, red/blue fringe that settles then breathes, perspective bow, slow scale drift"
---
-`typography` `title-card` `creator`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Chromatic Fringe Title block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add yt-prism-title
```
-## Details
+That writes one file: `compositions/yt-prism-title.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 6s |
+## Add it to your video
-**Installed files**
+It runs for 6 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `yt-prism-title.html` | `compositions/yt-prism-title.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `typography` `title-card` `creator`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/blocks/yt-vertical-fill.mdx b/docs/catalog/blocks/yt-vertical-fill.mdx
index 7f79dd6a15..429ea95c20 100644
--- a/docs/catalog/blocks/yt-vertical-fill.mdx
+++ b/docs/catalog/blocks/yt-vertical-fill.mdx
@@ -3,49 +3,39 @@ title: "Vertical Media Filler"
description: "Portrait media filling a widescreen frame via blurred-scale, mirror, or copy side fills; grid texture and foreground contrast lift (images inside the block; keep live footage in the host)"
---
-`placeholder` `vertical` `media`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Vertical Media Filler block from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add yt-vertical-fill
```
-## Details
+That writes one file: `compositions/yt-vertical-fill.html`.
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920Γ1080 |
-| Duration | 8s |
+## Add it to your video
-**Installed files**
+It runs for 8 seconds at 1920Γ1080. Paste this into your composition:
-| File | Target | Type |
-| --- | --- | --- |
-| `yt-vertical-fill.html` | `compositions/yt-vertical-fill.html` | hyperframes:composition |
-
-## Use it
-
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
-
-**Wiring it by hand.** The installed block can be added to a host composition with:
-
-```html
-
+```html index.html
+
```
+Move it in time with `data-start`. Put it on a different timeline row with
+`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
+
+{/* hf:generated-footer */}
+
+Tagged `placeholder` `vertical` `media`.
+
## Related topics
- [Browse the complete Catalog](/catalog)
diff --git a/docs/catalog/components/caption-blend-difference.mdx b/docs/catalog/components/caption-blend-difference.mdx
index e0ded30891..91ef41d36d 100644
--- a/docs/catalog/components/caption-blend-difference.mdx
+++ b/docs/catalog/components/caption-blend-difference.mdx
@@ -3,42 +3,27 @@ title: "Blend Difference"
description: "Auto-inverting text using mix-blend-mode: difference β flips between white and black per-pixel against the background"
---
-`text` `text-effect` `effect` `blend-mode` `contrast` `inversion`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Blend Difference component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add caption-blend-difference
```
-## Details
+That writes one file: `compositions/components/caption-blend-difference.html`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/caption-blend-difference.html` and copy what is inside into your own composition.
+The file opens with a comment header that walks you through it.
-| File | Target | Type |
-| --- | --- | --- |
-| `caption-blend-difference.html` | `compositions/components/caption-blend-difference.html` | hyperframes:snippet |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/caption-blend-difference.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `text` `text-effect` `effect` `blend-mode` `contrast` `inversion`.
## Related topics
diff --git a/docs/catalog/components/caption-clip-wipe.mdx b/docs/catalog/components/caption-clip-wipe.mdx
index 2b88a22853..d170381921 100644
--- a/docs/catalog/components/caption-clip-wipe.mdx
+++ b/docs/catalog/components/caption-clip-wipe.mdx
@@ -3,42 +3,26 @@ title: "Clip Wipe"
description: "Left-to-right clip-path wipe reveal per word"
---
-`captions` `caption-style` `wipe` `clip-path` `reveal`
+
-
+## Install
-## Add it to a project
-
-### Ask your agent
-
-```text
-Add the Clip Wipe component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add caption-clip-wipe
```
-## Details
+That writes one file: `compositions/components/caption-clip-wipe.html`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/caption-clip-wipe.html` and copy what is inside into your own composition.
-| File | Target | Type |
-| --- | --- | --- |
-| `caption-clip-wipe.html` | `compositions/components/caption-clip-wipe.html` | hyperframes:snippet |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/caption-clip-wipe.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `captions` `caption-style` `wipe` `clip-path` `reveal`.
## Related topics
diff --git a/docs/catalog/components/caption-editorial-emphasis.mdx b/docs/catalog/components/caption-editorial-emphasis.mdx
index 2fe9be5a9b..b2111c041a 100644
--- a/docs/catalog/components/caption-editorial-emphasis.mdx
+++ b/docs/catalog/components/caption-editorial-emphasis.mdx
@@ -3,42 +3,26 @@ title: "Editorial Emphasis"
description: "Dual-font system with dramatic size contrast for emphasis words"
---
-`captions` `caption-style` `editorial` `typography` `emphasis`
+
-
+## Install
-## Add it to a project
-
-### Ask your agent
-
-```text
-Add the Editorial Emphasis component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add caption-editorial-emphasis
```
-## Details
+That writes one file: `compositions/components/caption-editorial-emphasis.html`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/caption-editorial-emphasis.html` and copy what is inside into your own composition.
-| File | Target | Type |
-| --- | --- | --- |
-| `caption-editorial-emphasis.html` | `compositions/components/caption-editorial-emphasis.html` | hyperframes:snippet |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/caption-editorial-emphasis.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `captions` `caption-style` `editorial` `typography` `emphasis`.
## Related topics
diff --git a/docs/catalog/components/caption-emoji-pop.mdx b/docs/catalog/components/caption-emoji-pop.mdx
index 36e0a51368..bbb8348b41 100644
--- a/docs/catalog/components/caption-emoji-pop.mdx
+++ b/docs/catalog/components/caption-emoji-pop.mdx
@@ -3,42 +3,26 @@ title: "Emoji Pop"
description: "Emoji integration with stroked text and horizontal squeeze entrance"
---
-`captions` `caption-style` `emoji` `social`
+
-
+## Install
-## Add it to a project
-
-### Ask your agent
-
-```text
-Add the Emoji Pop component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add caption-emoji-pop
```
-## Details
+That writes one file: `compositions/components/caption-emoji-pop.html`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/caption-emoji-pop.html` and copy what is inside into your own composition.
-| File | Target | Type |
-| --- | --- | --- |
-| `caption-emoji-pop.html` | `compositions/components/caption-emoji-pop.html` | hyperframes:snippet |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/caption-emoji-pop.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `captions` `caption-style` `emoji` `social`.
## Related topics
diff --git a/docs/catalog/components/caption-glitch-rgb.mdx b/docs/catalog/components/caption-glitch-rgb.mdx
index c236e0c6a9..1cc7a04383 100644
--- a/docs/catalog/components/caption-glitch-rgb.mdx
+++ b/docs/catalog/components/caption-glitch-rgb.mdx
@@ -3,42 +3,26 @@ title: "Glitch RGB"
description: "RGB chromatic aberration with CRT scanline overlay"
---
-`captions` `caption-style` `glitch` `cyber` `tech`
+
-
+## Install
-## Add it to a project
-
-### Ask your agent
-
-```text
-Add the Glitch RGB component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add caption-glitch-rgb
```
-## Details
+That writes one file: `compositions/components/caption-glitch-rgb.html`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/caption-glitch-rgb.html` and copy what is inside into your own composition.
-| File | Target | Type |
-| --- | --- | --- |
-| `caption-glitch-rgb.html` | `compositions/components/caption-glitch-rgb.html` | hyperframes:snippet |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/caption-glitch-rgb.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `captions` `caption-style` `glitch` `cyber` `tech`.
## Related topics
diff --git a/docs/catalog/components/caption-gradient-fill.mdx b/docs/catalog/components/caption-gradient-fill.mdx
index b991f2f3b8..fcc64ac141 100644
--- a/docs/catalog/components/caption-gradient-fill.mdx
+++ b/docs/catalog/components/caption-gradient-fill.mdx
@@ -3,42 +3,26 @@ title: "Gradient Fill"
description: "Gradient-clipped text with elastic bounce entrance"
---
-`captions` `caption-style` `gradient` `colorful`
+
-
+## Install
-## Add it to a project
-
-### Ask your agent
-
-```text
-Add the Gradient Fill component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add caption-gradient-fill
```
-## Details
+That writes one file: `compositions/components/caption-gradient-fill.html`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/caption-gradient-fill.html` and copy what is inside into your own composition.
-| File | Target | Type |
-| --- | --- | --- |
-| `caption-gradient-fill.html` | `compositions/components/caption-gradient-fill.html` | hyperframes:snippet |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/caption-gradient-fill.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `captions` `caption-style` `gradient` `colorful`.
## Related topics
diff --git a/docs/catalog/components/caption-highlight.mdx b/docs/catalog/components/caption-highlight.mdx
index 3aa89acf9c..3f3ad6e607 100644
--- a/docs/catalog/components/caption-highlight.mdx
+++ b/docs/catalog/components/caption-highlight.mdx
@@ -3,42 +3,26 @@ title: "Highlight"
description: "Red background sweep behind each active word, TikTok-style"
---
-`captions` `caption-style` `highlight` `social` `tiktok`
+
-
+## Install
-## Add it to a project
-
-### Ask your agent
-
-```text
-Add the Highlight component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add caption-highlight
```
-## Details
+That writes one file: `compositions/components/caption-highlight.html`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/caption-highlight.html` and copy what is inside into your own composition.
-| File | Target | Type |
-| --- | --- | --- |
-| `caption-highlight.html` | `compositions/components/caption-highlight.html` | hyperframes:snippet |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/caption-highlight.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `captions` `caption-style` `highlight` `social` `tiktok`.
## Related topics
diff --git a/docs/catalog/components/caption-kinetic-slam.mdx b/docs/catalog/components/caption-kinetic-slam.mdx
index 4551ca5264..efb32ef2c7 100644
--- a/docs/catalog/components/caption-kinetic-slam.mdx
+++ b/docs/catalog/components/caption-kinetic-slam.mdx
@@ -3,42 +3,26 @@ title: "Kinetic Slam"
description: "Full-screen single-word display with alternating entrance directions"
---
-`captions` `caption-style` `kinetic` `typography` `slam`
+
-
+## Install
-## Add it to a project
-
-### Ask your agent
-
-```text
-Add the Kinetic Slam component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add caption-kinetic-slam
```
-## Details
+That writes one file: `compositions/components/caption-kinetic-slam.html`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/caption-kinetic-slam.html` and copy what is inside into your own composition.
-| File | Target | Type |
-| --- | --- | --- |
-| `caption-kinetic-slam.html` | `compositions/components/caption-kinetic-slam.html` | hyperframes:snippet |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/caption-kinetic-slam.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `captions` `caption-style` `kinetic` `typography` `slam`.
## Related topics
diff --git a/docs/catalog/components/caption-matrix-decode.mdx b/docs/catalog/components/caption-matrix-decode.mdx
index 09b84d85b9..d363539901 100644
--- a/docs/catalog/components/caption-matrix-decode.mdx
+++ b/docs/catalog/components/caption-matrix-decode.mdx
@@ -3,42 +3,26 @@ title: "Matrix Decode"
description: "Character scramble animation before text reveal"
---
-`captions` `caption-style` `matrix` `scramble` `decode`
+
-
+## Install
-## Add it to a project
-
-### Ask your agent
-
-```text
-Add the Matrix Decode component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add caption-matrix-decode
```
-## Details
+That writes one file: `compositions/components/caption-matrix-decode.html`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/caption-matrix-decode.html` and copy what is inside into your own composition.
-| File | Target | Type |
-| --- | --- | --- |
-| `caption-matrix-decode.html` | `compositions/components/caption-matrix-decode.html` | hyperframes:snippet |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/caption-matrix-decode.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `captions` `caption-style` `matrix` `scramble` `decode`.
## Related topics
diff --git a/docs/catalog/components/caption-neon-accent.mdx b/docs/catalog/components/caption-neon-accent.mdx
index f13fe98381..1ab8619c42 100644
--- a/docs/catalog/components/caption-neon-accent.mdx
+++ b/docs/catalog/components/caption-neon-accent.mdx
@@ -3,42 +3,26 @@ title: "Neon Accent"
description: "Multi-color neon glow accents with wiggle drift animation"
---
-`captions` `caption-style` `neon` `glow` `accent`
+
-
+## Install
-## Add it to a project
-
-### Ask your agent
-
-```text
-Add the Neon Accent component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add caption-neon-accent
```
-## Details
+That writes one file: `compositions/components/caption-neon-accent.html`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/caption-neon-accent.html` and copy what is inside into your own composition.
-| File | Target | Type |
-| --- | --- | --- |
-| `caption-neon-accent.html` | `compositions/components/caption-neon-accent.html` | hyperframes:snippet |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/caption-neon-accent.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `captions` `caption-style` `neon` `glow` `accent`.
## Related topics
diff --git a/docs/catalog/components/caption-neon-glow.mdx b/docs/catalog/components/caption-neon-glow.mdx
index fda30b00e0..54302cbcfa 100644
--- a/docs/catalog/components/caption-neon-glow.mdx
+++ b/docs/catalog/components/caption-neon-glow.mdx
@@ -3,42 +3,26 @@ title: "Neon Glow"
description: "Cyan and magenta neon glow with keyword accent colors"
---
-`captions` `caption-style` `neon` `glow` `gaming`
+
-
+## Install
-## Add it to a project
-
-### Ask your agent
-
-```text
-Add the Neon Glow component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add caption-neon-glow
```
-## Details
+That writes one file: `compositions/components/caption-neon-glow.html`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/caption-neon-glow.html` and copy what is inside into your own composition.
-| File | Target | Type |
-| --- | --- | --- |
-| `caption-neon-glow.html` | `compositions/components/caption-neon-glow.html` | hyperframes:snippet |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/caption-neon-glow.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `captions` `caption-style` `neon` `glow` `gaming`.
## Related topics
diff --git a/docs/catalog/components/caption-parallax-layers.mdx b/docs/catalog/components/caption-parallax-layers.mdx
index 4d8f7e4aa9..d0ae48c6ad 100644
--- a/docs/catalog/components/caption-parallax-layers.mdx
+++ b/docs/catalog/components/caption-parallax-layers.mdx
@@ -3,42 +3,26 @@ title: "Parallax Layers"
description: "Behind-subject 3D text layering with vertical stretch effect"
---
-`captions` `caption-style` `parallax` `3d` `depth`
+
-
+## Install
-## Add it to a project
-
-### Ask your agent
-
-```text
-Add the Parallax Layers component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add caption-parallax-layers
```
-## Details
+That writes one file: `compositions/components/caption-parallax-layers.html`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/caption-parallax-layers.html` and copy what is inside into your own composition.
-| File | Target | Type |
-| --- | --- | --- |
-| `caption-parallax-layers.html` | `compositions/components/caption-parallax-layers.html` | hyperframes:snippet |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/caption-parallax-layers.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `captions` `caption-style` `parallax` `3d` `depth`.
## Related topics
diff --git a/docs/catalog/components/caption-particle-burst.mdx b/docs/catalog/components/caption-particle-burst.mdx
index 9d510dfe7b..898ea1e0ee 100644
--- a/docs/catalog/components/caption-particle-burst.mdx
+++ b/docs/catalog/components/caption-particle-burst.mdx
@@ -3,42 +3,26 @@ title: "Particle Burst"
description: "Keyword words trigger colored particle explosions"
---
-`captions` `caption-style` `particles` `burst` `effects`
+
-
+## Install
-## Add it to a project
-
-### Ask your agent
-
-```text
-Add the Particle Burst component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add caption-particle-burst
```
-## Details
+That writes one file: `compositions/components/caption-particle-burst.html`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/caption-particle-burst.html` and copy what is inside into your own composition.
-| File | Target | Type |
-| --- | --- | --- |
-| `caption-particle-burst.html` | `compositions/components/caption-particle-burst.html` | hyperframes:snippet |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/caption-particle-burst.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `captions` `caption-style` `particles` `burst` `effects`.
## Related topics
diff --git a/docs/catalog/components/caption-pill-karaoke.mdx b/docs/catalog/components/caption-pill-karaoke.mdx
index bf33f2bdc5..09f5b0db51 100644
--- a/docs/catalog/components/caption-pill-karaoke.mdx
+++ b/docs/catalog/components/caption-pill-karaoke.mdx
@@ -3,42 +3,26 @@ title: "Pill Karaoke"
description: "Pill-shaped container with per-word karaoke color highlight"
---
-`captions` `caption-style` `karaoke` `pill`
+
-
+## Install
-## Add it to a project
-
-### Ask your agent
-
-```text
-Add the Pill Karaoke component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add caption-pill-karaoke
```
-## Details
+That writes one file: `compositions/components/caption-pill-karaoke.html`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/caption-pill-karaoke.html` and copy what is inside into your own composition.
-| File | Target | Type |
-| --- | --- | --- |
-| `caption-pill-karaoke.html` | `compositions/components/caption-pill-karaoke.html` | hyperframes:snippet |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/caption-pill-karaoke.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `captions` `caption-style` `karaoke` `pill`.
## Related topics
diff --git a/docs/catalog/components/caption-texture.mdx b/docs/catalog/components/caption-texture.mdx
index d3f1199caa..b771c36574 100644
--- a/docs/catalog/components/caption-texture.mdx
+++ b/docs/catalog/components/caption-texture.mdx
@@ -3,48 +3,26 @@ title: "Texture"
description: "Flowing texture mask over large uppercase text β ships with 6 textures (lava, marble, metal, wood, concrete, rock), configurable via the texture variable"
---
-`captions` `caption-style` `texture` `mask`
+
-
+## Install
-## Add it to a project
-
-### Ask your agent
-
-```text
-Add the Texture component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add caption-texture
```
-## Details
+That writes `compositions/components/caption-texture.html`, plus 6 supporting files under `compositions/components/`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/caption-texture.html` and copy what is inside into your own composition.
-| File | Target | Type |
-| --- | --- | --- |
-| `caption-texture.html` | `compositions/components/caption-texture.html` | hyperframes:snippet |
-| `lava.png` | `compositions/components/lava.png` | hyperframes:asset |
-| `marble-012.png` | `compositions/components/marble-012.png` | hyperframes:asset |
-| `metal-046-b.png` | `compositions/components/metal-046-b.png` | hyperframes:asset |
-| `wood-066.png` | `compositions/components/wood-066.png` | hyperframes:asset |
-| `concrete-042-a.png` | `compositions/components/concrete-042-a.png` | hyperframes:asset |
-| `rock-058.png` | `compositions/components/rock-058.png` | hyperframes:asset |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/caption-texture.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `captions` `caption-style` `texture` `mask`.
## Related topics
diff --git a/docs/catalog/components/caption-weight-shift.mdx b/docs/catalog/components/caption-weight-shift.mdx
index bbff555fc8..90b91b5e5d 100644
--- a/docs/catalog/components/caption-weight-shift.mdx
+++ b/docs/catalog/components/caption-weight-shift.mdx
@@ -3,42 +3,26 @@ title: "Weight Shift"
description: "Elegant font-weight transition between caption lines"
---
-`captions` `caption-style` `minimal` `typography`
+
-
+## Install
-## Add it to a project
-
-### Ask your agent
-
-```text
-Add the Weight Shift component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add caption-weight-shift
```
-## Details
+That writes one file: `compositions/components/caption-weight-shift.html`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/caption-weight-shift.html` and copy what is inside into your own composition.
-| File | Target | Type |
-| --- | --- | --- |
-| `caption-weight-shift.html` | `compositions/components/caption-weight-shift.html` | hyperframes:snippet |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/caption-weight-shift.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `captions` `caption-style` `minimal` `typography`.
## Related topics
diff --git a/docs/catalog/components/grain-overlay.mdx b/docs/catalog/components/grain-overlay.mdx
index a4ac17d506..20adf620fa 100644
--- a/docs/catalog/components/grain-overlay.mdx
+++ b/docs/catalog/components/grain-overlay.mdx
@@ -3,42 +3,27 @@ title: "Grain Overlay"
description: "Animated film grain texture overlay using CSS keyframes β adds warmth and analog character to any composition"
---
-`texture` `grain` `overlay` `film`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Grain Overlay component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add grain-overlay
```
-## Details
+That writes one file: `compositions/components/grain-overlay.html`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/grain-overlay.html` and copy what is inside into your own composition.
+The file opens with a comment header that walks you through it.
-| File | Target | Type |
-| --- | --- | --- |
-| `grain-overlay.html` | `compositions/components/grain-overlay.html` | hyperframes:snippet |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/grain-overlay.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `texture` `grain` `overlay` `film`.
## Related topics
diff --git a/docs/catalog/components/grid-pixelate-wipe.mdx b/docs/catalog/components/grid-pixelate-wipe.mdx
index 2ce38abcc4..9ebe64c678 100644
--- a/docs/catalog/components/grid-pixelate-wipe.mdx
+++ b/docs/catalog/components/grid-pixelate-wipe.mdx
@@ -3,42 +3,27 @@ title: "Grid Pixelate Wipe"
description: "Transition effect where the screen dissolves into a grid of squares that fade out with staggered timing β use between scenes"
---
-`transition` `wipe` `grid` `pixelate`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Grid Pixelate Wipe component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add grid-pixelate-wipe
```
-## Details
+That writes one file: `compositions/components/grid-pixelate-wipe.html`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/grid-pixelate-wipe.html` and copy what is inside into your own composition.
+The file opens with a comment header that walks you through it.
-| File | Target | Type |
-| --- | --- | --- |
-| `grid-pixelate-wipe.html` | `compositions/components/grid-pixelate-wipe.html` | hyperframes:snippet |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/grid-pixelate-wipe.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `transition` `wipe` `grid` `pixelate`.
## Related topics
diff --git a/docs/catalog/components/hw-arrow.mdx b/docs/catalog/components/hw-arrow.mdx
index 083e643a58..f493c0272f 100644
--- a/docs/catalog/components/hw-arrow.mdx
+++ b/docs/catalog/components/hw-arrow.mdx
@@ -3,43 +3,26 @@ title: "Hand-Drawn Arrow"
description: "Wobbled draw-on arrow with straight, gentle, and swoop curve presets; boils while on screen"
---
-`handwritten` `annotation` `arrow` `overlay`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Hand-Drawn Arrow component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add hw-arrow
```
-## Details
+That writes `compositions/components/hw-arrow.html`, plus 1 supporting file under `assets/fonts/`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/hw-arrow.html` and copy what is inside into your own composition.
-| File | Target | Type |
-| --- | --- | --- |
-| `hw-arrow.html` | `compositions/components/hw-arrow.html` | hyperframes:snippet |
-| `assets/fonts/Caveat-700-latin.woff2` | `assets/fonts/Caveat-700-latin.woff2` | hyperframes:asset |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/hw-arrow.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `handwritten` `annotation` `arrow` `overlay`.
## Related topics
diff --git a/docs/catalog/components/hw-boil.mdx b/docs/catalog/components/hw-boil.mdx
index c184d513df..5883808aaf 100644
--- a/docs/catalog/components/hw-boil.mdx
+++ b/docs/catalog/components/hw-boil.mdx
@@ -3,43 +3,26 @@ title: "Hand-Drawn Boil"
description: "Hand-drawn jitter that re-poses every N frames, as seek-safe helpers: pose derives from quantized timeline time through a seeded hash; includes the shared onUpdate dispatcher and a wobbled-ellipse path generator"
---
-`handwritten` `effect` `annotation`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Hand-Drawn Boil component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add hw-boil
```
-## Details
+That writes `compositions/components/hw-boil.html`, plus 1 supporting file under `assets/fonts/`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/hw-boil.html` and copy what is inside into your own composition.
-| File | Target | Type |
-| --- | --- | --- |
-| `hw-boil.html` | `compositions/components/hw-boil.html` | hyperframes:snippet |
-| `assets/fonts/Caveat-700-latin.woff2` | `assets/fonts/Caveat-700-latin.woff2` | hyperframes:asset |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/hw-boil.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `handwritten` `effect` `annotation`.
## Related topics
diff --git a/docs/catalog/components/hw-box-label.mdx b/docs/catalog/components/hw-box-label.mdx
index ed8cdf1f8e..323da55c7b 100644
--- a/docs/catalog/components/hw-box-label.mdx
+++ b/docs/catalog/components/hw-box-label.mdx
@@ -3,43 +3,26 @@ title: "Hand-Drawn Box Label"
description: "Wobbled rounded rectangle draws around a region with a handwritten label above or centered"
---
-`handwritten` `annotation` `overlay`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Hand-Drawn Box Label component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add hw-box-label
```
-## Details
+That writes `compositions/components/hw-box-label.html`, plus 1 supporting file under `assets/fonts/`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/hw-box-label.html` and copy what is inside into your own composition.
-| File | Target | Type |
-| --- | --- | --- |
-| `hw-box-label.html` | `compositions/components/hw-box-label.html` | hyperframes:snippet |
-| `assets/fonts/Caveat-700-latin.woff2` | `assets/fonts/Caveat-700-latin.woff2` | hyperframes:asset |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/hw-box-label.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `handwritten` `annotation` `overlay`.
## Related topics
diff --git a/docs/catalog/components/hw-callout-circle.mdx b/docs/catalog/components/hw-callout-circle.mdx
index 95cb3b42cf..9066ff2afb 100644
--- a/docs/catalog/components/hw-callout-circle.mdx
+++ b/docs/catalog/components/hw-callout-circle.mdx
@@ -3,43 +3,26 @@ title: "Scribble Callout Circle"
description: "Wobbled ellipse draws around a target with optional scribble fill, curved connector, and handwritten label"
---
-`handwritten` `annotation` `callout` `overlay`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Scribble Callout Circle component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add hw-callout-circle
```
-## Details
+That writes `compositions/components/hw-callout-circle.html`, plus 1 supporting file under `assets/fonts/`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/hw-callout-circle.html` and copy what is inside into your own composition.
-| File | Target | Type |
-| --- | --- | --- |
-| `hw-callout-circle.html` | `compositions/components/hw-callout-circle.html` | hyperframes:snippet |
-| `assets/fonts/Caveat-700-latin.woff2` | `assets/fonts/Caveat-700-latin.woff2` | hyperframes:asset |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/hw-callout-circle.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `handwritten` `annotation` `callout` `overlay`.
## Related topics
diff --git a/docs/catalog/components/hw-underline.mdx b/docs/catalog/components/hw-underline.mdx
index f2cbad2ea4..04bf6f266e 100644
--- a/docs/catalog/components/hw-underline.mdx
+++ b/docs/catalog/components/hw-underline.mdx
@@ -3,43 +3,26 @@ title: "Squiggle Marks"
description: "Hand-drawn squiggle underline, double-pass strikethrough, and bracket marks that draw on"
---
-`handwritten` `annotation` `text-treatment`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Squiggle Marks component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add hw-underline
```
-## Details
+That writes `compositions/components/hw-underline.html`, plus 1 supporting file under `assets/fonts/`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/hw-underline.html` and copy what is inside into your own composition.
-| File | Target | Type |
-| --- | --- | --- |
-| `hw-underline.html` | `compositions/components/hw-underline.html` | hyperframes:snippet |
-| `assets/fonts/Caveat-700-latin.woff2` | `assets/fonts/Caveat-700-latin.woff2` | hyperframes:asset |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/hw-underline.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `handwritten` `annotation` `text-treatment`.
## Related topics
diff --git a/docs/catalog/components/mk-emphasis-type.mdx b/docs/catalog/components/mk-emphasis-type.mdx
index f2d32b2ffd..c5561ebd8a 100644
--- a/docs/catalog/components/mk-emphasis-type.mdx
+++ b/docs/catalog/components/mk-emphasis-type.mdx
@@ -3,42 +3,26 @@ title: "Background Emphasis Type"
description: "Oversized low-contrast background word drifting slowly behind the subject β typography as texture"
---
-`typography` `text-treatment` `minimal`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Background Emphasis Type component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add mk-emphasis-type
```
-## Details
+That writes one file: `compositions/components/mk-emphasis-type.html`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/mk-emphasis-type.html` and copy what is inside into your own composition.
-| File | Target | Type |
-| --- | --- | --- |
-| `mk-emphasis-type.html` | `compositions/components/mk-emphasis-type.html` | hyperframes:snippet |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/mk-emphasis-type.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `typography` `text-treatment` `minimal`.
## Related topics
diff --git a/docs/catalog/components/mk-usage-arc.mdx b/docs/catalog/components/mk-usage-arc.mdx
index 711bd2aab2..340ed69214 100644
--- a/docs/catalog/components/mk-usage-arc.mdx
+++ b/docs/catalog/components/mk-usage-arc.mdx
@@ -3,42 +3,26 @@ title: "Hairline Arc Gauge"
description: "Thin circular gauge that draws on while its percentage counts up; one helper call drives both"
---
-`data-viz` `gauge` `minimal`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Hairline Arc Gauge component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add mk-usage-arc
```
-## Details
+That writes one file: `compositions/components/mk-usage-arc.html`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/mk-usage-arc.html` and copy what is inside into your own composition.
-| File | Target | Type |
-| --- | --- | --- |
-| `mk-usage-arc.html` | `compositions/components/mk-usage-arc.html` | hyperframes:snippet |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/mk-usage-arc.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `data-viz` `gauge` `minimal`.
## Related topics
diff --git a/docs/catalog/components/morph-text.mdx b/docs/catalog/components/morph-text.mdx
index 8979d996b3..66b9051859 100644
--- a/docs/catalog/components/morph-text.mdx
+++ b/docs/catalog/components/morph-text.mdx
@@ -3,42 +3,26 @@ title: "Morph Text"
description: "Gooey text morph β cycles through an editable word list using SVG threshold + GSAP-driven blur for a fluid, satisfying transition effect"
---
-`text` `text-effect` `typography` `morph` `gooey` `kinetic` `animation`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Morph Text component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add morph-text
```
-## Details
+That writes one file: `compositions/components/morph-text.html`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/morph-text.html` and copy what is inside into your own composition.
-| File | Target | Type |
-| --- | --- | --- |
-| `morph-text.html` | `compositions/components/morph-text.html` | hyperframes:snippet |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/morph-text.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `text` `text-effect` `typography` `morph` `gooey` `kinetic` `animation`.
## Related topics
diff --git a/docs/catalog/components/motion-blur.mdx b/docs/catalog/components/motion-blur.mdx
index 446155f47d..f8c1a6b138 100644
--- a/docs/catalog/components/motion-blur.mdx
+++ b/docs/catalog/components/motion-blur.mdx
@@ -3,42 +3,27 @@ title: "Motion Blur"
description: "Velocity-driven motion blur β samples element position each frame and applies a one-sided SVG feGaussianBlur ghost trail proportional to speed"
---
-`effect` `motion-blur` `velocity` `animation` `physics`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Motion Blur component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add motion-blur
```
-## Details
+That writes one file: `compositions/components/motion-blur.html`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/motion-blur.html` and copy what is inside into your own composition.
+The file opens with a comment header that walks you through it.
-| File | Target | Type |
-| --- | --- | --- |
-| `motion-blur.html` | `compositions/components/motion-blur.html` | hyperframes:snippet |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/motion-blur.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `effect` `motion-blur` `velocity` `animation` `physics`.
## Related topics
diff --git a/docs/catalog/components/parallax-unzoom.mdx b/docs/catalog/components/parallax-unzoom.mdx
index 20da1e0504..1fbeef7c0f 100644
--- a/docs/catalog/components/parallax-unzoom.mdx
+++ b/docs/catalog/components/parallax-unzoom.mdx
@@ -3,42 +3,27 @@ title: "Parallax Unzoom"
description: "Reveal transition β focus card scales down from full frame as siblings parallax in to form a grid (reverse of parallax-zoom)"
---
-`transition` `reveal` `unzoom` `parallax` `grid` `hero`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Parallax Unzoom component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add parallax-unzoom
```
-## Details
+That writes one file: `compositions/components/parallax-unzoom.html`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/parallax-unzoom.html` and copy what is inside into your own composition.
+The file opens with a comment header that walks you through it.
-| File | Target | Type |
-| --- | --- | --- |
-| `parallax-unzoom.html` | `compositions/components/parallax-unzoom.html` | hyperframes:snippet |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/parallax-unzoom.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `transition` `reveal` `unzoom` `parallax` `grid` `hero`.
## Related topics
diff --git a/docs/catalog/components/parallax-zoom.mdx b/docs/catalog/components/parallax-zoom.mdx
index 023f857338..21b895f518 100644
--- a/docs/catalog/components/parallax-zoom.mdx
+++ b/docs/catalog/components/parallax-zoom.mdx
@@ -3,42 +3,27 @@ title: "Parallax Zoom"
description: "Center card scales up to fill the frame while siblings parallax outward β inspired by the eBay Playbook hero transition"
---
-`transition` `zoom` `parallax` `grid` `hero`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Parallax Zoom component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add parallax-zoom
```
-## Details
+That writes one file: `compositions/components/parallax-zoom.html`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/parallax-zoom.html` and copy what is inside into your own composition.
+The file opens with a comment header that walks you through it.
-| File | Target | Type |
-| --- | --- | --- |
-| `parallax-zoom.html` | `compositions/components/parallax-zoom.html` | hyperframes:snippet |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/parallax-zoom.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `transition` `zoom` `parallax` `grid` `hero`.
## Related topics
diff --git a/docs/catalog/components/shimmer-sweep.mdx b/docs/catalog/components/shimmer-sweep.mdx
index 24afc874e0..ede8830937 100644
--- a/docs/catalog/components/shimmer-sweep.mdx
+++ b/docs/catalog/components/shimmer-sweep.mdx
@@ -3,42 +3,27 @@ title: "Shimmer Sweep"
description: "Animated light sweep across text or elements using a CSS gradient mask β ideal for AI accents and premium reveals"
---
-`text` `shimmer` `highlight` `effect`
-
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Shimmer Sweep component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add shimmer-sweep
```
-## Details
+That writes one file: `compositions/components/shimmer-sweep.html`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-**Installed files**
+Open `compositions/components/shimmer-sweep.html` and copy what is inside into your own composition.
+The file opens with a comment header that walks you through it.
-| File | Target | Type |
-| --- | --- | --- |
-| `shimmer-sweep.html` | `compositions/components/shimmer-sweep.html` | hyperframes:snippet |
+A component has no size or duration of its own. It takes both from the composition
+you paste it into.
-## Use it
+{/* hf:generated-footer */}
-Ask your agent to apply the component to the intended element and preserve the projectβs existing timing.
-
-**Wiring it by hand.** Open `compositions/components/shimmer-sweep.html` and paste its contents into your composition. The comment header in that file contains any item-specific instructions.
+Tagged `text` `shimmer` `highlight` `effect`.
## Related topics
diff --git a/docs/catalog/components/texture-mask-text.mdx b/docs/catalog/components/texture-mask-text.mdx
index 7d676eaf22..bda1928dc4 100644
--- a/docs/catalog/components/texture-mask-text.mdx
+++ b/docs/catalog/components/texture-mask-text.mdx
@@ -3,8 +3,6 @@ title: "Texture Mask Text"
description: "CSS luminance masks that cut holes through letterforms - 66 pre-built texture masks from ambientCG PBR color maps"
---
-`text` `text-effect` `effect` `texture` `mask`
-
Brick
@@ -32,30 +30,24 @@ description: "CSS luminance masks that cut holes through letterforms - 66 pre-bu
-## Add it to a project
+## Install
-### Ask your agent
-
-```text
-Add the Texture Mask Text component from the HyperFrames Catalog to this project.
-Replace the demo content with mine and match the existing design and timing.
-```
-
-### Install from the terminal
-
-```bash
+```bash Terminal
npx hyperframes add texture-mask-text
```
-## Details
+That writes `compositions/components/texture-mask-text/texture-mask-text.html`, plus 66 supporting files under `assets/texture-mask-text/masks/`.
-| Property | Value |
-| --- | --- |
-| Type | Component |
+## Paste it into your composition
-## Agent Usage
+Open `compositions/components/texture-mask-text/texture-mask-text.html`. Paste the real `
+
+
+
+
+ ```
+
+ `data-playback-start` picks which moment of the child timeline shows first.
+ It defaults to `0`. Trimming or splitting from the left pushes this offset
+ forward by the time elapsed multiplied by `data-playback-rate`, so the
+ nested animation keeps going instead of jumping back to its beginning.
+
+
+ Write the nested composition straight into the parent. Simpler for
+ something you only use once.
+
+ ```html index.html
+
+
+
+
+
Welcome!
+
+
+
+
+ ```
+
+ No `` tag and no `data-composition-src` here.
+
+
+
+### Where the files live
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+## HTML sets the timing, scripts do the motion
+
+Your HTML says what plays, when, and on which track, all through
+[data attributes](/concepts/data-attributes). Your scripts handle the creative
+part: effects, transitions, canvas, SVG, [GSAP](/guides/gsap-animation)
+animation.
+
+
+ Never use a script to play, pause, or seek a media element, and never use one
+ to show or hide a clip based on time. The framework already does that from the
+ data attributes, and a script doing it too will fight the framework. See
+ [Common Mistakes](/guides/troubleshooting) for what that looks like.
+
+
+## Reuse one composition with different content
+
+One source file can appear several times in the same video, each copy carrying
+its own text and colors. HyperFrames does not wire `data-var-*` attributes into
+your DOM or CSS for you β you do it in three steps:
+
+1. Declare each variable β id, type, default β on the sub-composition's root
+ with `data-composition-variables`. That root is the `` element in a
+ full-document composition, or the `[data-composition-id]` element in a
+ template or fragment.
+2. Pass each copy's values on its host element with `data-variable-values`.
+3. Read them inside the composition with
+ `window.__hyperframes.getVariables()`, which layers the host's values over
+ the declared defaults, one copy at a time.
+
+```html index.html
+
```
-`data-composition-src` paths resolve from the project root, even when the referencing composition is inside another folder.
+The second card's `data-start="card-pro"` means "start when that one ends".
-This tells HyperFrames to mount `product-demo.html` at four seconds and show a six-second window of it. The nested source keeps its own content and animation.
+And the source file both cards share:
-If the same source is mounted more than once, each instance can start at a different time or receive different [variables](/concepts/variables).
+```html compositions/card.html
+
+
+
+
-## Decide where to make a change
+
-- Edit the **nested composition** when the scene itself should change everywhere it is used.
-- Edit the **main composition** when only its placement, duration, or relationship to other scenes should change.
-- Ask the **agent** when a revision changes the story or crosses several compositions.
+
+
+
+
+```
-In Studio, open or expand a nested scene when you need to work inside it, then use the breadcrumb to return to the parent sequence.
+[Variables](/concepts/variables) covers the types, the bindings that need no
+script, CLI overrides, and which value wins. If you are building tooling on
+`@hyperframes/core`, `extractCompositionMetadata()` reads the same
+`data-composition-variables` array β that is how Studio builds its editing UI.
-## Continue
+## See every composition in a project
-Use [Variables](/concepts/variables) when the design should stay fixed while approved content changes. Use the [HTML schema](/reference/html-schema) when you need exact element and attribute rules.
+```bash
+npx hyperframes compositions
+```
+
+## Related topics
+
+- [Data attributes](/concepts/data-attributes)
+- [Deterministic rendering](/concepts/determinism)
+- [Variables](/concepts/variables)
+- [Animate with GSAP](/guides/gsap-animation)
+- [HTML schema reference](/reference/html-schema)
+- [Start from an example](/examples)
diff --git a/docs/concepts/determinism.mdx b/docs/concepts/determinism.mdx
index 87f9b63755..dc3aeff4c1 100644
--- a/docs/concepts/determinism.mdx
+++ b/docs/concepts/determinism.mdx
@@ -1,72 +1,97 @@
---
title: Deterministic Rendering
-description: "Make every frame depend on the playhead, not the wall clock."
+description: "Same input, identical output. Every time."
---
-HyperFrames renders by seeking to one frame at a time. A well-authored composition can therefore reproduce the same state whenever the renderer seeks to the same frame.
+The same [composition](/concepts/compositions) always produces the same video.
+That is the guarantee everything else rests on β it is why automated pipelines,
+CI tests, and AI-driven editing can be trusted.
-This is what makes a slow animation safe to render: the renderer does not need to play it in real time, and it does not drop frames when a frame takes longer to produce.
+## Why the same frame always comes out the same
-## The rendering model
+Rendering never plays your video. It asks for one frame at a time, and the
+answer to "what does frame 90 look like?" depends on exactly one thing that
+changes: the number 90.
-For each output frame, HyperFrames:
-
-1. converts the frame number to a time;
-2. seeks the registered animation adapter to that state;
-3. updates time-based media and composition state;
-4. captures the frame;
-5. sends the result to the encoder.
-
-The preview and renderer use the same composition runtime. Preview performance can still depend on your computer, while the final render advances frame by frame.
-
-## What your composition must control
-
-The frame must be reproducible from its inputs and current time.
-
-- Use a paused, registered timeline instead of animation driven by `requestAnimationFrame`.
-- Do not use `Date.now()` or the current system time.
-- Seed random values instead of calling unseeded `Math.random()`.
-- Keep assets local or make sure they are fully available before rendering.
-- Give the composition a finite duration, dimensions, and frame rate.
-- Make custom frame adapters safe to seek in any order.
-
-Run both checks before a final render:
-
-```bash
-npx hyperframes lint
-npx hyperframes check
+```mermaid
+flowchart TD
+ F["Frame 90"] --> T
+ L["Locked before frame 0: fps, width, height, variables"] --> T
+ T["t = 90 / fps integer math, never a clock"] --> S["Every animation seeked to exactly t"]
+ S --> P["The same pixels, every run"]
+ S -.-> X["Breaks if a frame reads: Date.now, unseeded Math.random, or a mid-render fetch"]
```
-## What βrepeatableβ does not mean
+So the rules are short:
-Seek-driven rendering controls time. It does not make different computers identical.
+- **No wall clock.** No `Date.now()`, no `requestAnimationFrame`, no system
+ timers.
+- **No unseeded randomness.** `Math.random()` without a seed gives a different
+ frame every run.
+- **No fetching mid-render.** Every asset loads before the first frame.
+- **Fixed output size.** `fps`, `width`, and `height` are locked before frame 0.
+- **A finite length.** Every composition has a known end.
-Chrome versions, installed fonts, GPU behavior, operating systems, and encoder versions can produce small differences even when the composition is unchanged. If exact reproduction across machines matters, render in the same controlled environment:
+## What happens on each frame
+
+
+
+ The [engine](/packages/engine) works out the time with integer math:
+ `time = floor(frame) / fps`. Real time is never consulted.
+
+
+ The [frame adapter](/concepts/frame-adapters) gets `seekFrame(frame)` and
+ moves every animation, DOM change, and canvas draw to that exact moment. All
+ [GSAP](/guides/gsap-animation) timelines are paused and seeked, never played.
+
+
+ Chrome's `HeadlessExperimental.beginFrame` grabs the pixels in one atomic
+ operation. No half-painted frames.
+
+
+ FFmpeg turns the captured frames into the MP4 and mixes in the audio from
+ your `
+
+
+Every [frame adapter](/concepts/frame-adapters) follows these same rules. If you
+write your own, it must follow the
+[determinism contract](/concepts/frame-adapters#contract):
+`seekFrame(frame)` gives the same result for the same frame, seeks work in any
+order, nothing resolves after the frame is committed, and the lifecycle stays
+`init` β `seekFrame` (many times) β `destroy`.
+
+## Rule out your machine as a variable
+
+Fonts and Chrome versions differ between computers, so a local render can shift
+by a pixel from one machine to the next. Render in Docker when you need exact
+reproducibility:
```bash
npx hyperframes render --docker --output output.mp4
```
-Docker reduces environment differences by using a controlled browser, font, and encoder setup. Keep the same assets and render settings as well.
+Docker pins the Chromium version, the font set, and the FFmpeg encoder, so the
+platform stops being an input. The [Rendering guide](/guides/rendering) covers
+every other option.
-## For frame-adapter authors
+## Will the preview match the render?
-A frame adapter must follow four rules:
+Every frame looks the same in both, because both run the same
+`hyperframe.runtime`, the [producer's](/packages/producer) seek behavior is the
+single source of truth, and the `__playerReady` and `__renderReady` gates hold
+capture until the composition is fully loaded.
-- seeking the same frame twice returns the same state;
-- frames can be requested out of order;
-- no unfinished asynchronous work changes the committed frame later;
-- `destroy()` leaves no state behind for the next render.
+Speed is a different story. Preview plays in real time in your browser, so it is
+limited by your hardware. Render is seek-driven and takes one frame at a time,
+so it never drops a frame no matter how expensive that frame is. A composition
+that stutters in preview still renders perfectly β see
+[Performance](/guides/performance).
-See [Frame adapters](/concepts/frame-adapters) for the interface and a complete example.
+## Related topics
-## Continue
-
-
-
- Choose local, Docker, batch, or cloud rendering.
-
-
- Understand preview speed, capture cost, and render time.
-
-
+- [Frame adapters](/concepts/frame-adapters)
+- [Render to MP4](/guides/rendering)
+- [Compositions](/concepts/compositions)
+- [@hyperframes/producer](/packages/producer)
+- [Common mistakes that break determinism](/guides/troubleshooting)
diff --git a/docs/concepts/frame-adapters.mdx b/docs/concepts/frame-adapters.mdx
index 463d0db9b4..9b2c75be5f 100644
--- a/docs/concepts/frame-adapters.mdx
+++ b/docs/concepts/frame-adapters.mdx
@@ -14,6 +14,26 @@ Most composition authors do not implement this interface. HyperFrames already se
Use `FrameAdapter` when you are building a custom host around a seekable animation object.
+Rendering never plays the animation. It asks for one frame, waits, captures it,
+then asks for the next β so the same frame always comes out the same.
+
+```mermaid
+sequenceDiagram
+ participant R as Renderer
+ participant A as Frame adapter
+ participant T as Your timeline
+ R->>A: getDurationFrames()
+ A-->>R: 120
+ loop every frame, in any order
+ R->>A: seekFrame(90)
+ A->>T: jump to 3.0s and settle
+ T-->>A: state at 3.0s
+ A-->>R: ready
+ R->>R: capture the pixels
+ end
+ R->>A: destroy()
+```
+
## Interface
```ts
diff --git a/docs/concepts/index.mdx b/docs/concepts/index.mdx
index ad6650a3f4..657661a728 100644
--- a/docs/concepts/index.mdx
+++ b/docs/concepts/index.mdx
@@ -8,6 +8,20 @@ A HyperFrames project is a folder your agent can create and you can keep
editing. Its HTML is the video: it describes the scenes, timing, motion, media,
and reusable parts that HyperFrames plays or renders.
+One folder of HTML is the whole video. Every tool below reads and writes those
+same files β there is no export step between them and no second version of the
+project.
+
+```mermaid
+flowchart TD
+ S["Your project folder HTML, CSS, media"]
+ A["Agent story and structure"] <--> S
+ T["Studio what you can point at"] <--> S
+ C["CLI check, preview, render"] <--> S
+ K["SDK and Player inside your own product"] <--> S
+ S --> R["renders/final.mp4"]
+```
+
## The source is the project
The agent, Studio, CLI, SDK, and Player do not create separate versions of the
@@ -60,12 +74,13 @@ A **composition** is a finite, seekable piece of the project. The main
composition is the complete sequence. Other compositions can be scenes,
captions, title systems, or visuals reused more than once.
-```text
-Main video
-βββ Opening
-βββ Product demo
-βββ Customer proof
-βββ Closing
+```mermaid
+flowchart LR
+ M["index.html the main composition"]
+ M --> O["Opening 0s - 4s"]
+ M --> P["Product demo 4s - 10s compositions/product-demo.html"]
+ M --> C["Customer proof 10s - 15s"]
+ M --> Z["Closing 15s - 18s"]
```
Each part is still HTML. A larger project stays manageable because a scene can
diff --git a/docs/concepts/variables.mdx b/docs/concepts/variables.mdx
index 3446143867..72f5fa8b98 100644
--- a/docs/concepts/variables.mdx
+++ b/docs/concepts/variables.mdx
@@ -113,14 +113,18 @@ A parent can reuse the same composition several times:
data-composition-id="card-pro"
data-composition-src="compositions/card.html"
data-start="0"
- data-variable-values='{"title":"Pro","accent":"#ff4d4f"}'
+ data-duration="3"
+ data-track-index="1"
+data-variable-values='{"title":"Pro","accent":"#ff4d4f"}'
>
```
diff --git a/docs/contributing/canary-rollouts.mdx b/docs/contributing/canary-rollouts.mdx
index cbb0408ad0..daa765ad80 100644
--- a/docs/contributing/canary-rollouts.mdx
+++ b/docs/contributing/canary-rollouts.mdx
@@ -3,26 +3,20 @@ title: "Canary rollouts"
description: "Ship a change to a percentage of installs instead of all-or-nothing."
---
-Most flags in this repo are binary: a feature is off (and therefore never
-exercised on real traffic) or on for everyone (and therefore a fleet-wide
-bet). A canary is the rung in between β the same change, enabled for a stable
-slice of installs, ramped as the signal holds.
+Most flags in this repo are binary: a change is off, or on for everyone. A
+canary is the rung in between β the same change, enabled for a stable slice of
+installs, ramped as the signal holds.
- **Canaries are part of telemetry, not a separate system.** A canary is a
- *measured* rollout: a slice is enrolled specifically so it can be compared
- against everyone else, and the comparison is what makes ramping safe. An
- install that reports nothing cannot be compared, so **opting out of telemetry
- opts you out of canaries** β via `hyperframes telemetry disable`,
- `HYPERFRAMES_NO_TELEMETRY=1`, `DO_NOT_TRACK=1`, a dev build, or Studio's
- `hyperframes-studio:telemetryDisabled`. See the
- [`telemetry` command](/packages/cli#telemetry) for what is collected and how
- to turn it off; everything on this page sits behind that switch.
+ A canary is a *measured* rollout: a slice is enrolled so it can be compared
+ against everyone else. So **opting out of telemetry opts you out of
+ canaries** β an opted-out install is never bucketed at all. See the
+ [`telemetry` command](/packages/cli#telemetry) for the opt-out routes.
## Add one
-**1. Register it at 0%.** In `packages/core/src/canaryRegistry.ts`:
+**1. Register it at 0%** in `packages/core/src/canaryRegistry.ts`:
```ts
{
@@ -48,232 +42,40 @@ if (isCanaryEnabled("my-feature")) {
}
```
-That is the whole API. The percentage lives in the registry, never at the
-call site.
+That is the whole API. The percentage lives in the registry, never at the call
+site.
**3. Ramp it** by editing `percentage` in a patch release: `0 β 5 β 25 β 100`.
+Widening is inclusive β everyone already in the 10 stays in the 25, so a
+before/after comparison survives the ramp. Do not rename a live canary: the
+name is part of the bucket hash, so renaming reshuffles the cohort mid-rollout.
-**4. Delete it** once it is at 100 and holding β both the registry entry and
-the branch it guarded. `sunsetAfter` exists to force this: the scheduled
-**Canary sunset** workflow runs weekly and fails once the date passes, naming
-the overdue rollout and its owner in the run log. It does not notify anyone β
-watch the workflow if you own a canary.
+**4. Delete it** at 100 and holding β the registry entry *and* the branch it
+guarded. The scheduled **Canary sunset** workflow enforces this: it runs weekly
+and fails once `sunsetAfter` passes, naming the overdue rollout and its owner in
+the run log. It notifies nobody, so watch it if you own a canary. Run it
+yourself with `bun scripts/check-canary-sunset.ts`.
-It is a scheduled job rather than a PR check on purpose. A current-date
-assertion in the unit suite would redden builds for authors who changed
-nothing related, on a calendar date, with no fix available to them β so the
-failure is routed to the person who can actually ramp or remove the canary.
-Run it yourself with `bun scripts/check-canary-sunset.ts`.
-
-## Overriding
+## Override one
```bash
HF_CANARY_MY_FEATURE=on # or off / true / false / 1 / 0 / yes / no
```
-Upper-snake-case the name. An override always wins over the percentage, in
-both directions β use it for support escalations, dogfooding, bisects, or a
-panic-off.
+Upper-snake-case the name. In Studio, use `?hf_canary_my_feature=on`. An
+override always wins over the percentage, in both directions β escalations,
+dogfooding, bisects, a panic-off. It is also the way to exercise a canary with
+telemetry off.
-## Measuring
+Everything else fails closed below 100%: no bucket seed, an unregistered name,
+or a CI machine all resolve to *not enrolled*. At exactly 100% those exclusions
+stop applying, so nothing takes the new path for the first time at deletion.
-Every telemetry event carries the assignment as a flag-shaped property:
+## Remove one from your machine
-```
-$feature/canary-my-feature: "true" | "false"
-```
-
-`$feature/` is the de-facto flag-property convention in analytics
-tooling, so whoever operates the telemetry backend can split any metric by
-cohort with **nothing configured server-side** β while the decision itself
-still happens locally and offline, which the render path requires.
-(Assignments ride the same anonymous, opt-out telemetry pipeline as every
-other event β and disabling telemetry disables the **enrolment**, not just the
-reporting: an opted-out install is never bucketed at all. See the note at the
-top of this page.)
-
-Two details worth knowing:
-
-- **Both arms are emitted.** A non-enrolled install reports `"false"`, not a
- missing property. Absent means *this build predates the canary*, which is a
- different fact from *this install is control* β collapsing them makes a ramp
- unreadable.
-- **Keys are namespaced with `canary-`.** The `$feature/` namespace is shared
- with real product feature flags elsewhere in the analytics pipeline. The
- infix guarantees a canary can never alias one and fight it for the same
- property.
-
-## Cumulative exposure β the number that actually bounds blast radius
-
-The instantaneous share holds at the target forever: enrolment is a pure
-function of `(feature, installId, percentage)` and fresh ids are uniformly
-random, so ~10% of active installs and ~10% of renders are enrolled on any
-given day. That part does not drift.
-
-**The cumulative set does grow.** Install ids churn β measured on the desktop
-render population, there are ~25Γ more distinct ids over 30 days than in any
-single day. Ten percent of a pool that keeps turning over is a steadily larger
-group of installs that have been enrolled *at some point*. If a single person
-cycles through N ids during a rollout, their chance of having been exposed is
-`1 β (1 β p)^N`, so at 10%: 19% after two ids, 41% after five.
-
-So the number that bounds blast radius is *distinct installs ever enrolled
-during the window*, not the instantaneous rate. Two practical consequences:
-
-- **Keep canaries short.** Drift compounds with time; a 5-day window at 10% is
- far tighter than a 60-day one.
-- **The percentage is not the safety mechanism.** It bounds *initial* exposure
- and decays from there. Per-render verification and per-install circuit
- breakers are what actually bound harm. A breaker's tripped state lives in
- `install-state.json`, separate from `config.json` and merged back in on every
- read, so a `config.json` re-mint cannot re-enrol an install into a path that
- already failed it. Deleting `~/.hyperframes` clears both, deliberately β
- that is the user's reset.
-
-For *measurement* β "is this feature better?" β churn is harmless: re-bucketing
-is random, so it adds noise, not bias. It is specifically the blast-radius
-guarantee that degrades.
-
-## Calibration: validating the mechanism in the wild
-
-Two inert canaries β `calibration-10` (10%) and `calibration-50` (50%) β gate
-nothing and exist only to prove the mechanism behaves as designed on real
-traffic. Their percentages stay FIXED for the whole window, which is what
-makes check 3 below meaningful: while a percentage is constant, a cohort flip
-is a bug, whereas during a real ramp a `false β true` flip is correct and
-expected.
-
-Four checks, written down before the data arrives so the read is not post-hoc.
-(The maintainers monitor these on an internal dashboard; the definitions live
-here so the experiment's terms are public and fixed.)
-
-**1. Accuracy β does 10% mean 10%?** Measured install-weighted AND
-event-weighted separately: render volume is heavily skewed toward a few heavy
-installs, so the two can differ even when bucketing is perfect. Install share
-is the one that must land on target.
-
-**2. Drift β does cumulative exposure climb?** Measured over widening windows
-(1/7/14/30 days). The instantaneous share should stay flat at 10%; the
-cumulative enrolled-install count should grow with id churn.
-
-**3. Stability β does any install ever change cohort?** MUST be zero. A single
-id reporting both `true` and `false` at a fixed percentage means something is
-broken: memoization, a registry edit mid-window, or two code paths
-disagreeing. One innocent explanation to rule out first on a small-nonzero
-read: events carry the assignment but not the decision *reason*, so a dev
-toggling `HF_CANARY_CALIBRATION_10=on/off` mid-window is indistinguishable
-from a real flip. Emitting a reason property is deliberately skipped β add it
-only if this check comes back dirty.
-
-**4. Cross-surface agreement β do CLI and Studio agree for the same install?**
-A CLI-launched Studio adopts the CLI's id, so the same install must report the
-same cohort on both. Disagreement means the two bindings have diverged. This
-compares the *value reported per surface* β any disagreement here is also a
-check-3 flip, so this check's job is attribution: it isolates the flips that
-are binding divergence rather than within-surface instability.
-
-**Independence bonus:** overlap between `calibration-10` and `calibration-50`
-should be ~5% of installs (p1 x p2), not ~10% (which would mean the slices are
-correlated and every canary hits the same unlucky cohort).
-
-### What passing looks like, and what cannot be fixed
-
-Checks 1, 3 and 4 should pass outright β they are properties of the design,
-and failing any of them is a bug to fix before shipping a real rollout.
-
-Check 2 will NOT come back flat, and that is expected rather than a defect.
-Per-install cohorts never flip, but a *person* who wipes their config gets a
-new id and a fresh roll of the dice. Preventing that entirely needs a stable
-identity across resets, and both candidates were rejected: hardware
-fingerprinting correlates the cohort with hardware (fatal for a rendering
-experiment, and it survives uninstall), and account identity covers only
-~3.6% of local rendering installs. So the drift itself stands as a measured,
-accepted limit β but its worst consequence is mitigated, and its size is now
-directly measurable rather than inferred:
-
-- **Cohorts survive a config re-mint.** Canaries bucket on a dedicated
- `bucketSeed` β not the telemetry id β held in `install-state.json` beside
- `config.json` and write-once (the first install's seed wins forever). This
- matters because `config.json` is rewritten on every command and every
- render, and any parse/permission/IO failure makes the CLI mint a fresh
- identity. The seed is never emitted, so it does not link the old id to the
- new one.
-- **Deleting `~/.hyperframes` clears the cohort too, deliberately.** The seed
- does not live outside the config directory, so the user's reset is a real
- reset. A seed that outlived it would be a persistent identifier defeating
- the only lever they have β see [the removal path](#removing-your-canary-state).
-- **A re-minted install cannot re-enter a path that already failed on that
- machine.** The circuit breaker's tripped state is mirrored to the same
- state file.
-- **`install_predecessor_found`** on every event says whether this install's
- mint found a previous install's state marker β i.e. `config.json` was lost
- while `install-state.json` survived. Its true-share is the re-mint rate
- directly; drift from a deliberate reset, a fresh machine, a container, or a
- new user is not linkable by any local mechanism and is not counted.
-
-With the seed carryover, check 2's residual drift comes from the
-unrecoverable buckets only β deliberate resets, fresh machines, containers,
-and genuinely new users β and canary window lengths get picked from that
-residual, not the raw turnover.
-
-## Behaviour worth knowing
-
-**Ramping is inclusive.** Widening `10 β 25` keeps everyone who was already
-in the 10. Cohorts never reshuffle, so a before/after comparison stays valid
-across a ramp.
-
-**Slices are independent per feature.** The bucket hashes `feature:seed`,
-not the seed alone β two canaries at 10% select two different 10%s. If
-they shared a slice, one unlucky cohort would receive every experiment at
-once and no two rollouts could be read apart.
-
-**Cohorts are keyed to the install directory, not to `config.json`.** The
-bucketing unit is a dedicated seed in `install-state.json`, inherited across
-`config.json` re-mints (see the calibration section) β distinct from the
-telemetry id and never emitted. It does not outlive `~/.hyperframes`.
-
-**A CLI-launched Studio adopts the CLI's decisions rather than re-deriving
-them.** The CLI publishes `window.__HF_CLI_CANARY_DECISIONS` β a
-`{ name: { enabled, forced } }` map. Re-deriving cannot agree in the cases
-that matter: telemetry off (the CLI resolves `telemetry_opt_out`, but Studio's
-opt-out is a separate localStorage flag it cannot see), an `HF_CANARY_*`
-override (env vars never cross into the browser), or no seed injected (Studio
-falls back to a different unit, so a different bucket). One render spanning
-both surfaces must not run half-enrolled.
-
-`forced` carries the provenance, and the precedence follows from it β highest
-first:
-
-1. A **forced** CLI decision (`HF_CANARY_*`). Wins outright, including over
- this profile's opt-out, exactly as a local URL override does.
-2. A local `?hf_canary_*=` override, same reasoning.
-3. **This profile's telemetry opt-out.** Checked before any percentage
- decision: the two surfaces have independent opt-outs, and CLI telemetry
- being on says nothing about whether this browser profile agreed to be
- measured. A cohort roll must never enrol an opted-out profile.
-4. The CLI's percentage decision.
-5. Local evaluation (standalone Studio, or a canary the CLI did not publish).
-
-Identity is treated differently from decisions. `__HF_CLI_DISTINCT_ID` and
-`__HF_CLI_BUCKET_SEED` are injected only for a `Host` this server can vouch
-for β a page that rebinds its hostname to `127.0.0.1` would otherwise read
-them as same-origin. That means loopback by default, and on an explicit LAN
-bind (`HYPERFRAMES_PREVIEW_HOST=0.0.0.0`) a `Host` naming an address or
-hostname this machine actually answers on. Setting the variable does not
-disable the check; a hostile `Host` is refused in either mode.
-
-The decisions map is not identifying, so it is published regardless, which
-keeps a LAN preview in agreement with the CLI instead of silently
-re-deriving.
-
-The decisions map is published even when telemetry is off β that is the case
-it exists for. It is safe to expose where the seed is not: booleans about
-features, not the value cohorts are derived from. Studio still evaluates
-locally when opened standalone, or for any canary the CLI did not publish.
-
-## Removing your canary state
-
-Both `config.json` and `install-state.json` live in `~/.hyperframes`, so:
+Cohorts bucket on a seed in `install-state.json`, which sits beside
+`config.json` in `~/.hyperframes` β not on the telemetry id. So a full reset is
+one command:
```bash
rm -rf ~/.hyperframes # clears telemetry id, canary cohorts, and breaker state
@@ -282,48 +84,24 @@ rm -rf ~/.hyperframes # clears telemetry id, canary cohorts, and breaker stat
`hyperframes telemetry status` prints both paths if you want to inspect or
delete them individually. Nothing canary-related is stored anywhere else.
-**Opting out of telemetry opts you out of canaries.** A canary is a *measured*
-rollout β we enrol a slice precisely so it can be compared against everyone
-else. An install that sends nothing can't be compared, so enrolling it buys no
-signal and only changes that user's code path, on an experimental feature,
-without their knowledge. Every opt-out route counts: the persisted preference
-(`hyperframes telemetry disable`), the runtime env vars
-(`HYPERFRAMES_NO_TELEMETRY`, `DO_NOT_TRACK`), dev/telemetry-disabled builds,
-and Studio's `hyperframes-studio:telemetryDisabled`. The decision resolves to
-`telemetry_opt_out` *before* bucketing, so no cohort is assigned at all.
-
-An explicit `HF_CANARY_` (or `?hf_canary_=` in Studio)
-override still wins β that is a deliberate local choice, and it stays the way
-to exercise a canary with telemetry off.
-
-**It fails closed below 100%.** No install id, an unregistered name, or a CI
-machine all resolve to *not enrolled*. A canary exists to bound blast radius,
-so "we don't know who this is" must never mean "enrol everyone". CI is
-excluded because its config is regenerated per run, so its ids are ephemeral
-and would hop cohorts between runs β an explicit override still reaches it,
-which is how you test a canary in CI.
-
-At exactly 100% those exclusions stop applying, deliberately. 100% is the step
-before deleting the entry and the guard, so anything still resolving false
-there would take the new path for the FIRST time at deletion, unstaged β and
-CI and seedless installs are precisely the populations a dashboard cannot see,
-so "100% and holding" would look green while they were never exercised.
-
-**Decisions are stable and memoized.** The same install always resolves the
-same way, and the answer is fixed for the life of a process β a render that
-starts enrolled finishes enrolled, and its telemetry agrees with what ran.
-
-**Do not rename a live canary.** The name is part of the hash, so renaming
-reshuffles the cohort mid-rollout and invalidates the comparison.
-
## Where it lives
| File | Role |
| --- | --- |
-| `packages/core/src/canary.ts` | Pure evaluator β no fs, no network, browser-safe |
| `packages/core/src/canaryRegistry.ts` | Every rollout, with owner and sunset date |
-| `packages/cli/src/telemetry/canary.ts` | CLI binding: install id, env override, CI detection |
+| `packages/core/src/canary.ts` | Pure evaluator β no fs, no network, browser-safe |
+| `packages/cli/src/telemetry/canary.ts` | CLI binding: bucket seed, env override, CI detection |
+| `packages/studio/src/telemetry/canary.ts` | Studio binding: adopts the CLI's published decisions |
-The evaluator is deliberately dependency-free so studio and the embeddable
-player can use it too; those surfaces need their own thin binding to supply an
-id, since only the CLI has `anonymousId`.
+The evaluator is dependency-free so Studio and the embeddable player can use it
+too; each surface supplies its own unit id through a thin binding. Studio
+adopts the CLI's decisions rather than re-deriving them, so one render spanning
+both surfaces never runs half-enrolled.
+
+## Related topics
+
+- [Testing local changes](/contributing/testing-local-changes) β exercise your
+ canary before anyone else gets it.
+- [Release channels](/contributing/release-channels) β which branch a ramp belongs on.
+- [`telemetry` command](/packages/cli#telemetry) β what is collected, and how a
+ user turns it off.
diff --git a/docs/contributing/testing-local-changes.mdx b/docs/contributing/testing-local-changes.mdx
index a0f5031960..ea911bdfb4 100644
--- a/docs/contributing/testing-local-changes.mdx
+++ b/docs/contributing/testing-local-changes.mdx
@@ -41,10 +41,14 @@ hyperframes check
hyperframes preview
```
-Remove the link when finished:
+Remove the link when finished. `bun unlink` takes no package name β it
+unregisters whichever directory you run it from, so go back to the CLI package in
+your HyperFrames checkout first (an absolute path, since you are now inside the
+video project):
```bash
-bun unlink hyperframes
+cd /path/to/hyperframes/packages/cli
+bun unlink
```
### Call the built entry directly
diff --git a/docs/custom.css b/docs/custom.css
index b0b3b147f2..3352c918a6 100644
--- a/docs/custom.css
+++ b/docs/custom.css
@@ -182,6 +182,16 @@ h3 {
object-fit: cover;
pointer-events: none;
}
+/* A route with no preview clip: same box, no black rectangle. */
+.hf-workflow-route-noclip {
+ display: block;
+ width: 100%;
+ aspect-ratio: 16 / 9;
+ margin: 0;
+ border-radius: 0.5rem;
+ background: color-mix(in srgb, currentColor 8%, transparent);
+}
+
.hf-workflow-route-title {
display: block;
@@ -1116,3 +1126,24 @@ samp {
.eyebrow {
display: none;
}
+
+/* ββ UX-pass tweaks (Ular): brand the Playground CTA, align the logo ββ */
+@media (min-width: 1024px) {
+ /* Line the logo up with the sidebar text (was flush at the navbar padding, 16px further left). */
+ #navbar a[href*="/introduction"] {
+ margin-left: 16px;
+ }
+
+ /* Paint the Playground pill with the HyperFrames mark's own cyanβgreen gradient
+ (#06E3FA β #4FDB5E) instead of the muted primary-dark, with dark text for contrast. */
+ #navbar a.group > span.bg-primary-dark {
+ background: linear-gradient(100deg, #06e3fa 0%, #4fdb5e 100%) !important;
+ }
+ #navbar a.group:has(> span.bg-primary-dark) {
+ color: #0a2a20 !important;
+ }
+ #navbar a.group:has(> span.bg-primary-dark) span:not(.bg-primary-dark),
+ #navbar a.group:has(> span.bg-primary-dark) svg {
+ color: #0a2a20 !important;
+ }
+}
diff --git a/docs/developers/cli.mdx b/docs/developers/cli.mdx
index 9c9a4957a9..36baba88d2 100644
--- a/docs/developers/cli.mdx
+++ b/docs/developers/cli.mdx
@@ -36,18 +36,13 @@ remains authoritative: run `npx hyperframes --help`.
| Add a Catalog item | `npx hyperframes add ` |
| List compositions | `npx hyperframes compositions` |
| Inspect keyframe behavior | `npx hyperframes keyframes` |
-| Compare outputs | `npx hyperframes compare` |
+| Compare two or more versions | `npx hyperframes compare v1/ v2/` |
## Rendering and automation
-The CLI also supports:
-
-- batch and variable-driven output;
-- image sequences and several video formats;
-- managed cloud rendering;
-- AWS Lambda and Google Cloud Run workflows;
-- machine-readable JSON output;
-- publishing and shared spaces.
+The CLI also renders in batches and from variables, writes image sequences and
+several video formats, and runs in the cloud β managed, on AWS Lambda, or on
+Google Cloud Run. Most commands take `--json` when you need to read the result from a script.
Start with the simple command, then open the [full reference](/packages/cli) for the exact options needed by automation or infrastructure.
diff --git a/docs/developers/index.mdx b/docs/developers/index.mdx
index 60dd10874a..ad6cad33b7 100644
--- a/docs/developers/index.mdx
+++ b/docs/developers/index.mdx
@@ -9,7 +9,7 @@ import { DocsVideo } from "/snippets/docs-video.jsx";
@@ -28,8 +28,7 @@ cd my-video
npx hyperframes preview
```
-The project is ordinary HTML. The Reference Project used in the beginner path
-starts with this real composition root:
+The project is ordinary HTML. A composition starts with this root:
```html
-## One project, open end to end
+### Motion, sound & effects
-The same ten-second project the Quickstart builds. This is its actual render,
-and the folder behind it is public β not a sealed demo.
+Motion is the message β kinetic type, beat-synced cuts, texture and VFX.
-
-
+
+
+
+
Texture launchMotion design Β· 100% HyperFrames
+
+
+
+
VFX reelShaders and effects Β· 100% HyperFrames
+
+
+
+
Music to videoCuts synced to a track Β· 100% HyperFrames
-
- Every file exactly as it renders β the composition, the caption overlay, the
- measured word timings, and the brief the agent worked from.
-
+### Workflows & integrations
+
+A PR, a Figma file, a design brief β turned into a finished film.
+
+
Open models (Ollama)Build with local models Β· 100% HyperFrames
+
+
+
+
Community Β· hyperframes.devPublish and remix Β· 100% HyperFrames
+
+
+
+
+## Recreate any video, 1:1
+
+Point HyperFrames at a finished video and it rebuilds the same film in editable HTML β
+gestures, type, timing and all. Below, each **reference** (the original, on the left) sits
+next to its **HyperFrames replica** (on the right), matched frame for frame.
+
+
+
+
+
## Start from a template
diff --git a/docs/go-further.mdx b/docs/go-further.mdx
index e74504bed5..741587a45d 100644
--- a/docs/go-further.mdx
+++ b/docs/go-further.mdx
@@ -10,7 +10,7 @@ import { DocsVideo } from "/snippets/docs-video.jsx";
@@ -18,11 +18,6 @@ import { DocsVideo } from "/snippets/docs-video.jsx";
The project does not change format as you gain control. Your agent, Studio, the
SDK, the Player, and the renderer all work from the same HTML project.
-The [Reference Project](https://github.com/heygen-com/hyperframes/tree/main/examples/docs-reference-project)
-continues the first-video example. Its first version is a real page capture on a
-10-second timeline. The revised version keeps that source and adds editable
-variables, narration, fixed captions, music, and sound.
-
## Choose by the size of the change
Use the agent for changes to the story or several scenes. Use Studio for the
diff --git a/docs/guides/avatar-presenter.mdx b/docs/guides/avatar-presenter.mdx
index 8018336634..41ff85e1b2 100644
--- a/docs/guides/avatar-presenter.mdx
+++ b/docs/guides/avatar-presenter.mdx
@@ -13,7 +13,7 @@ music, and the final composition.
diff --git a/docs/guides/captions-and-recuts.mdx b/docs/guides/captions-and-recuts.mdx
index 1879970a46..f646583e55 100644
--- a/docs/guides/captions-and-recuts.mdx
+++ b/docs/guides/captions-and-recuts.mdx
@@ -4,17 +4,18 @@ sidebarTitle: "Captions and talking head"
description: "Add captions, add designed overlays, or change the spoken edit."
---
-
-
-
+import { DocsVideo } from "/snippets/docs-video.jsx";
+
+
+
+
+A verbatim rail, an embedded climax word, kinetic emphasis, a lower third and a
+pull-quote. The footage underneath is never re-edited β the overlays carry all
+of it.
## Make the request
@@ -30,9 +31,19 @@ quotes, statistics, lower thirds, or picture-in-picture.
## What should change?
-- **Add captions** β keep the original clip and audio unchanged; add readable, timed words over it.
-- **Add designed overlays** β keep the clip underneath and add titles, quotes, statistics, lower thirds, or picture-in-picture.
-- **Change the footage** β use General Video when pauses, selected moments, or the spoken order must change.
+This page covers two workflows. `/hyperframes` picks between them from what you
+ask for, and you can name one directly if you already know which you want.
+
+- **Words on screen** β `/embedded-captions`. Readable, timed words over the clip.
+ Plain subtitles, or cinematic captions set behind the subject.
+- **Designed cards on screen** β `/talking-head-recut`. Titles, pull-quotes, data
+ callouts, lower thirds, picture-in-picture, synced to the transcript.
+- **Change the footage itself** β neither of these. Use
+ [General Video](/guides/general-video) when pauses, selected moments, or the
+ spoken order must change.
+
+Both leave the clip and its audio untouched: the first adds words, the second adds
+graphics, and the footage plays the same underneath either way.
Captions and designed overlays work best on a clear, single-subject clip with audible speech. Both keep the original footage and audio intact.
diff --git a/docs/guides/choose-creation-path.mdx b/docs/guides/choose-creation-path.mdx
index 35382414f1..33d5d485db 100644
--- a/docs/guides/choose-creation-path.mdx
+++ b/docs/guides/choose-creation-path.mdx
@@ -1,70 +1,58 @@
---
title: "Choose how to create"
sidebarTitle: "Choose how to create"
-description: "Choose between a local HyperFrames project, hosted chat, a design-first handoff, or a HeyGen-generated video."
+description: "Four places to make a HyperFrames video, and how to tell which one is yours."
---
-## I want an editable project on my computer
+There are four places to make a HyperFrames video. They all give you a video.
+The difference is what you keep afterwards. Unsure? Take the first one.
-Use a coding agent with the HyperFrames skills. The agent writes an ordinary
-HTML project that you can revise with the agent, open in Studio, inspect in
-source, render locally, or automate later.
+| Start here | You end up with |
+| --- | --- |
+| A coding agent on your computer | A project folder you own and keep editing |
+| An AI chat | A video made and kept in your HeyGen account |
+| A design tool | A look to finish on your computer |
+| HeyGen Video Agent | A finished video, assembled for you |
-This is the default path for a video that will keep changing.
+## Start on your computer if the video will change
+
+A coding agent β an AI assistant that works in a folder on your machine, like
+Claude Code or Cursor β writes a plain HTML project. Revise it with the agent,
+open it in Studio, read the source, make the MP4 locally.
```text
Using /hyperframes, make a 10-second product intro for https://example.com.
```
-
- Install the skills and create the first editable version.
-
+[Make your first local video β](/quickstart)
-## I want to create inside an AI chat
+## Start in an AI chat if you want nothing installed
-Use the hosted HyperFrames MCP connector. It creates and renders through your
-HeyGen account without a local HyperFrames setup.
-
-Choose this when convenience matters more than owning the complete project
-folder. Rendering and account access are hosted; local Studio, source editing,
-self-hosting, and precise debugging belong to the local path.
+The hosted HyperFrames connector (an MCP connector β a plug-in an AI chat can
+use) builds and renders through your HeyGen account. You give up the project
+folder, Studio, and local rendering.
[Connect HyperFrames to an AI chat β](/guides/mcp)
-## I want to establish the visual direction first
+## Start in a design tool if the look is the open question
-Start in Figma, Claude Design, or Open Design when brand, layout, and scene
-direction are the unresolved part. Then hand the project to a coding agent for
-motion refinement, media, validation, and rendering.
-
-The design tool supplies a first draft, not a substitute for watching and
-checking the finished movement.
+Figma, Claude Design, and Open Design settle brand, layout, and scene direction
+first. Hand that draft to a coding agent for the motion, media, and rendering β
+no design tool can tell you whether the movement works.
[Bring a design into a project β](/guides/design-tools)
-## I want to create inside HeyGen
+## Start in HeyGen if you want it done for you
-Use HeyGen Video Agent when you want a hosted prompt-native workflow that
-assembles the script, visuals, narration, avatar, and motion for you. HyperFrames
-can power its HTML motion graphics, but the delivery surface is different: the
-local path gives you the project folder, source, Studio, and CLI; Video Agent
-keeps generation and revision inside HeyGen.
+HeyGen Video Agent takes a prompt and assembles the script, visuals, narration,
+avatar, and motion. It stays inside HeyGen β no folder, no source, no CLI β and
+it can draw on your account allowance or credits. Rendering on your own computer
+never does.
[Learn how HeyGen Video Agent works β](https://help.heygen.com/en/articles/12402907-how-to-get-started-with-video-agent)
-If a generated person is only one layer in a locally editable film, [add the
-presenter as media inside a HyperFrames project](/guides/avatar-presenter).
-HeyGen generation can use an account allowance or credits; local HyperFrames
-rendering does not.
-
-## If you are unsure
-
-Start with the local path. It preserves the most options because the project
-stays editable. Use the [developer journey](/developers) instead when your goal
-is an application or automated pipeline rather than one video.
-
## Related topics
- [Make a first local video](/quickstart)
-- [Create through a hosted AI chat](/guides/mcp)
-- [Bring a design into a HyperFrames project](/guides/design-tools)
+- [Add an avatar presenter to a project you can still edit](/guides/avatar-presenter)
+- [Build an app or a pipeline instead of one video](/developers)
diff --git a/docs/guides/color-grading.mdx b/docs/guides/color-grading.mdx
index e712bc3a65..a0a8a49d75 100644
--- a/docs/guides/color-grading.mdx
+++ b/docs/guides/color-grading.mdx
@@ -1,12 +1,15 @@
---
title: "Color grade images and footage"
sidebarTitle: "Color grading"
-description: "Correct exposure and color, shape a look, apply a LUT, and review the result in Studio."
+description: "Fix exposure and color on an image or video, shape a look with wheels and curves, apply a LUT, and check the result against real measurements."
---
-Use Color Grading when an image or video needs correction or a deliberate
-visual look. It changes that media element only; text, captions, SVG, and normal
-HTML remain separate layers.
+import { DocsVideo } from "/snippets/docs-video.jsx";
+
+Grading changes how a photo or video **looks** β brighter, warmer, moodier, more
+or less colorful. It runs on one media element at a time. The file on disk never
+changes, and text, captions, SVG and ordinary HTML stay on their own layers,
+untouched.
-## Work in this order
+
-| Pass | Purpose |
-| --- | --- |
-| Correct | Fix exposure, white balance, contrast, and saturation |
-| Grade | Shape tonal ranges or a selected color |
-| Apply a look | Start from a preset or a compatible `.cube` LUT |
-| Finish | Add restrained detail or film effects |
+Every control moves and the picture answers. The numbers on screen are measured
+from the frame, not illustrative β shadows lifted 2% to 23%, median 28% to 41%.
-Correct before stylizing. A strong preset cannot rescue clipped highlights,
-unreadable shadows, or the wrong source.
+## Correct first, then style
-## Grade in Studio
+Get exposure, white balance, contrast and saturation believable first. Then shape
+the tonal ranges or a single color, then a preset or a LUT, then grain, vignette
+and film effects last. No preset rescues blown-out highlights, shadows with
+nothing left in them, or the wrong shot.
-1. Select an image or video on the canvas, in Layers, or on the timeline.
-2. Open **Color grading** in **Design**.
-3. Start with a preset or small corrections.
-4. Use the scopes and compare control to check the result.
-5. Scrub several moments before judging moving footage.
+## Try it in Studio
-The controls answer different questions:
+Select an image or video β on the canvas, in Layers, or on the timeline β and
+open **Grade** in the Inspector.
+
+Start with a preset. There are thirteen, from Neutral and Clean Studio to Night Lift, and Studio renders each as a thumbnail of **your** frame rather than
+someone else's sample. **Strength** dials the chosen look between nothing and
+full.
+
+{/* VISUAL NEEDED (1): Studio's preset thumbnail grid β all thirteen Grade presets on one real frame, Neutral through Night Lift. */}
+
+Hold the compare button in the panel header to flash back to the original. On
+moving footage, scrub several places first β a grade that flatters one frame can
+wreck the next.
+
+## What each control does
| Control | Use it for |
| --- | --- |
-| Preset and strength | Establish a starting look |
-| Exposure, contrast, highlights, shadows, white point, black point | Correct brightness and contrast |
-| Warmth, tint, vibrance, saturation | Correct or shape color |
-| Color wheels | Shift shadows, midtones, or highlights |
-| RGB curves | Remap luminance or individual channels |
-| Hue curves | Move, saturate, or brighten a selected hue |
-| HSL selections | Correct pixels inside a hue, saturation, and luma range |
-| Grain, vignette, blur, and effects | Finish or deliberately degrade the image |
-| Custom LUT | Apply a known 3D `.cube` transform |
+| Preset and strength | Pick a whole look, then dial it back |
+| Exposure, contrast, highlights, shadows, whites, blacks | Brightness and contrast, overall and per tonal range |
+| Warmth, tint, vibrance, saturation | Take out a color cast, or push color further |
+| Color wheels | Tint shadows, midtones and highlights separately |
+| RGB curves | Redraw the brightness ramp β whole image, or red, green and blue one at a time |
+| Hue curves | Pick one hue and move only it: shift, saturate or brighten |
+| HSL selections | Key a band of hue, saturation and brightness, then correct only those pixels. Up to four, in order |
+| Grain and vignette | Add texture, or darken the edges to pull the eye in |
+| Custom LUT | Load a `.cube` file that maps every color to another |
-HyperFrames supports up to four ordered HSL selections. They are static
-pixel-value qualifiers, not object tracking, rotoscoping, or spatial masks.
+{/* VISUAL NEEDED (2): color wheels, a bent RGB curve, a hue curve and one HSL
+selection, each beside the frame it produced. */}
-Studio scopes are inspection tools:
+## Read the scopes, not your screen
-| Scope | Shows |
-| --- | --- |
-| Histogram | Overall dark-to-bright distribution |
-| Waveform | Brightness by horizontal image position |
-| RGB Parade | Channel balance and clipping |
-| Vectorscope | Hue direction and saturation |
+Scopes measure the picture live, so you are not guessing from a monitor that may
+be too bright. Studio draws four.
-## Give the agent the visible problem
+- **Histogram** β how much of the frame is dark, mid, or bright. Piled against
+ either end means detail is already gone.
+- **Waveform** β brightness across the frame left to right, so you see *which
+ part* is blown out.
+- **RGB parade** β that waveform split into red, green and blue. One channel
+ riding high is your color cast, named.
+- **Vectorscope** β a circle of hues: direction is which color, distance from the
+ centre is how saturated. Skin tones land on one known line, so faces are quick
+ to check.
-You do not need to prescribe shader values:
+{/* VISUAL NEEDED (3): the four scopes side by side, on the same frame before
+and after a correction. */}
+
+## Compare candidate looks in one image
+
+Instead of flipping between options, render them all onto one reference frame:
+
+```bash
+npx hyperframes grade-compare --for frame.png --grades grades.json
+```
+
+`--grades` takes a JSON array of `{ label, grading }` entries; `--for` takes an
+image, or a video sampled at its first frame. The untouched frame leads as a cell
+labelled `original` unless you pass `--no-baseline`. Up to sixteen cells land
+four to a row in `grade-compare.png`, or wherever `--out` points. Swap `--grades`
+for `--luts looks/a.cube,looks/b.cube` to compare LUT files the same way.
+
+{/* VISUAL NEEDED (4): a real grade-compare.png sheet β the labelled grid with
+`original` in the first cell. */}
+
+## Or describe the problem to the agent
+
+You do not need to name controls or invent values:
```text
The interview looks too dark and slightly cold.
Keep skin natural, recover the background enough to read, and avoid a filtered look.
```
-The agent can inspect the current capability contract and analyze a local
-source before changing it:
+The agent can list what exists, and measure a local source before changing it:
```bash
npx hyperframes media-treatment --capabilities --json
npx hyperframes media-treatment --selector '#interview' --analyze --json
```
-For source-sensitive prompts and worked A/B examples, continue to
+`--analyze` reports the source's color metadata, where its brightness sits, what
+is clipping, and a bounded correction to start from. For source-sensitive prompts
+and worked before-and-afters, see
[Color grading and film effects](/prompting/color-grading).
-## Reuse a grade carefully
+## Reuse a grade
-In Studio, use **Copy grade to** for other media in the current file or project.
-Treat the copy as a starting point and inspect each source.
+**Copy grade to** applies the current grade to other media, in this file or
+across the project β a starting point, since the same numbers rarely suit two
+shots. Project-wide copy refuses a relative LUT path, because that path means
+something different from another composition's folder; stay in the current file,
+or use a LUT reachable by URL or data URL.
-Project-wide copy rejects project-relative LUT paths because the same path can
-resolve differently from another composition. Use a project-root path, a data
-URL, or copy only within the current file.
+## Use a LUT only when you know what it expects
-## Use LUTs with known intent
+A LUT is a lookup table: a file mapping every input color to an output color.
+HyperFrames reads a 3D `.cube` file up to 64 points per side and blends it in at
+an intensity you set.
-Import a project-local 3D `.cube` LUT only when you know the look or conversion
-it expects. HyperFrames does not identify camera profiles or apply an automatic
-ACES/OCIO workflow.
+Nothing normalizes your footage first β HyperFrames does not identify camera
+profiles or run an ACES or OCIO pipeline, the color-management systems film
+finishing uses. The safe case is a creative Rec.709 LUT, built for ordinary web
+and broadcast video, which is also the only color space these controls work in.
+LOG footage, shot deliberately flat and grey so it holds detail for grading,
+needs the transform its camera expects or comes out wrong rather than stylized.
-A creative Rec.709 LUT is the safest normal path. LOG or HDR footage requires a
-known source transform.
+{/* VISUAL NEEDED (5): one frame under two or three .cube LUTs, plus the same
+LUT at partial and full intensity. */}
+## Where the grade is stored
-## Current limits
+Studio and the CLI write the result into `data-color-grading`, in named sections:
+corrections under `adjust`, grain and vignette under `details`, stylized
+treatments under `effects`.
-| Source or workflow | Status |
-| --- | --- |
-| SDR image or video | Supported |
-| 4K SDR media | Supported with higher preview and render cost |
-| iPhone HDR, HLG, or Dolby Vision-style media | Studio can show an SDR preview; native HDR delivery is a separate path |
-| LOG footage | Requires a known matching transform or LUT |
-| Full-scene grade including HTML text | Not supported; grading targets individual media elements |
-| Face or region tracking | Not supported |
-| Remote media | Requires compatible CORS headers |
-| ACES/OCIO finishing | Outside the current browser shader pipeline |
+```html
+
+```
-Continue to [Media effects](/guides/media-effects) for blur, bloom, retro,
-print, glitch, and art treatments. Use [HDR rendering](/guides/hdr) when the
-final delivery must remain HDR.
+The nesting is not optional. A flat object such as `{"exposure":0.15}` renders
+nothing at all; `npx hyperframes lint` catches it and names the section the
+control belongs in.
-
- Persist a grade, animate supported properties, or isolate a graded region.
-
+## What it cannot do
+
+Grading picks pixels by value, never by position: no face tracking, region
+tracking, rotoscoping or masks β an HSL selection is a color qualifier, not a
+shape. To treat one part of a frame, split it into its own media layer and grade
+that layer, as in the [implementation reference](/reference/color-grading). It
+targets media elements only, so a whole scene including HTML text cannot be
+graded.
+
+SDR images and video are the supported case; 4K works at a higher preview and
+render cost. An HDR source β iPhone HDR, HLG, Dolby Vision-style β gets an SDR
+preview and a banner saying so: the render may stay HDR-tagged, but this is not
+true HDR grading yet. Remote media needs permissive CORS headers and can vanish
+before render time, so keep media in the project.
+
+For blur, bloom, retro, print, glitch and art treatments, see
+[Media effects](/guides/media-effects).
## Related topics
- [Apply media effects](/guides/media-effects)
-- [Use images and video](/guides/video-components)
+- [Implement a grade in HTML](/reference/color-grading)
- [Deliver an HDR render](/guides/hdr)
diff --git a/docs/guides/deploy.mdx b/docs/guides/deploy.mdx
index cbc76099be..74219913db 100644
--- a/docs/guides/deploy.mdx
+++ b/docs/guides/deploy.mdx
@@ -4,6 +4,8 @@ sidebarTitle: "Hosted templates"
description: "Start from an official Vercel, Cloudflare, or Modal template when you need a hosted preview and MP4 render endpoint."
---
+import { DocsVideo } from "/snippets/docs-video.jsx";
+
HyperFrames has three official hosting templates. Each one previews a bundled
composition in `` and renders it to MP4 on server-side
Chrome and FFmpeg.
@@ -18,6 +20,15 @@ distributed infrastructure, or a Node backend, start with
| [Cloudflare](https://github.com/heygen-com/hyperframes-cloudflare-template) | Cloudflare Container | R2 | A Workers application that needs a containerized renderer |
| [Modal](https://github.com/heygen-com/hyperframes-modal-template) | Spawned Modal Function | Modal Volume | A Python service with render jobs that run outside the web request |
+
+
+Local machine, HeyGen cloud, AWS Lambda, Google Cloud Run β what each is for and
+what you trade. Anything not executed live is labelled on screen.
+
## Vercel
The Vercel template is a Next.js application. Its `/api/render` route restores
diff --git a/docs/guides/design-tools.mdx b/docs/guides/design-tools.mdx
index 76d30ca6ad..96da83cc5e 100644
--- a/docs/guides/design-tools.mdx
+++ b/docs/guides/design-tools.mdx
@@ -1,78 +1,90 @@
---
title: "Bring a design into a project"
sidebarTitle: "Bring in a design"
-description: "Start from Figma, a design-tool draft, or an existing brand system without turning the video into a stack of screenshots."
+description: "Start from a Figma file or a design-tool draft. Keep the look, rebuild only what has to move."
---
-Use an existing design as source material: preserve its visual language, then
-rebuild what must move as editable HyperFrames scenes.
+import { DocsVideo } from "/snippets/docs-video.jsx";
-## Choose what should remain editable
+Already have a design β Figma, a design-tool draft, a brand kit? One rule
+decides how each piece comes across:
-| Source | Keep as media | Rebuild in HTML |
-| --- | --- | --- |
-| Logo, icon, illustration, or textured artwork | Usually | Only when individual parts must animate |
-| Product screenshot | When a still proves the point | When the scene needs a real interaction or responsive crop |
-| Figma component | When exact pixels matter more than editing | When text, color, layout, or states must change |
-| Storyboard frames | Use as visual references | Reconstruct the intended motion between states |
-| Brand colors and type | Import the files and values | Apply them across the composition |
+**Pictures stay pictures. Anything that has to move or change gets rebuilt as
+real HTML β the editable code the video is made of.**
-Do not animate a stack of complete screenshots merely because they came from a
-design tool. Use screenshots for proof; use HTML for the parts that need to
-change.
+## What to keep as a picture
+
+Keep the export when the piece just sits there and looks right:
+
+- Logos, icons, illustrations, textured artwork.
+- A screenshot, when a still proves the point.
+- A Figma component, when exact pixels matter more than editing.
+- Storyboard frames, as references for the look.
+
+## What to rebuild in HTML
+
+Rebuild it when something inside changes while the video plays:
+
+- Parts of an illustration animate separately.
+- A screen shows a real interaction, or is re-cropped to another size.
+- Text, color, layout, or on/off states change.
+- Storyboard frames whose point is the motion between them β build that
+ movement, don't cut between finished frames.
+
+Brand colors and fonts: import once, use everywhere.
+
+Don't animate a stack of finished screenshots just because a design tool made
+them. Screenshots are proof. HTML is what changes.
+
+
+
+Both panels get the same clicks. Only the rebuilt side reacts, because a picture
+of a form cannot take input. That is the whole rule this page is about.
## Start from Figma
-Send the agent the Figma link and the outcome:
+Give the agent the link and the outcome:
```text
-Use this Figma section as the visual source for a 20-second product intro:
+Use this Figma section as the source for a 20-second product intro:
https://www.figma.com/design/FILE/Project?node-id=10-20
-Preserve the brand type and colors. Import artwork as local assets, rebuild the
-product states that need to move, and treat the frames as key moments rather
-than separate slides.
+Keep the brand type and colors. Rebuild the states that must move. Treat the
+frames as key moments, not slides.
```
-The agent can use the `/figma` skill to import assets, read brand values,
-reconstruct editable components, and translate supported motion. Everything
-required by the final render should end up as local project source.
-
-For tokens, API credentials, exact CLI commands, and import troubleshooting,
-use the [Figma integration reference](/guides/figma).
+The `/figma` skill imports artwork, reads brand values, rebuilds components as
+editable HTML, and translates motion where it can. It all lands in the project,
+so rendering never depends on Figma. Tokens, commands and errors:
+[Figma reference](/guides/figma).
## Start from Claude Design or Open Design
-These tools can establish layout, palette, type, and scene direction before a
-deeper production pass.
+These settle layout, palette, type, and scene direction first.
-1. Give the design tool the current HyperFrames instruction file and your real
- brand material.
-2. Ask for a valid project rather than isolated mockups.
-3. Download or save the project to disk.
-4. Open that folder with a coding agent.
-5. Let the agent validate timing, motion, media, captions, and rendering.
+1. Give the tool the HyperFrames instruction file and your brand material.
+2. Ask for a working project, not loose mockups.
+3. Save it to disk, then open that folder with a coding agent.
+4. Let the agent check timing, motion, media, captions, and rendering.
-[Claude Design instruction](https://github.com/heygen-com/hyperframes/blob/main/docs/guides/claude-design-hyperframes.md) Β· [Open Design handoff](https://github.com/heygen-com/hyperframes/blob/main/docs/guides/open-design-hyperframes.md)
+[Claude Design instruction](https://github.com/heygen-com/hyperframes/blob/main/docs/guides/design-tools-hyperframes.md) Β· [Open Design handoff](https://github.com/heygen-com/hyperframes/blob/main/docs/guides/open-design-hyperframes.md)
-## Judge the handoff
+## Is the handoff any good?
-A useful handoff has:
-
-- a clear visual direction;
-- real assets or honestly labeled placeholders;
-- editable source for anything likely to change;
-- stable local media and fonts;
-- a project that opens and can be checked.
-
-Run:
+A good one has a clear direction, real assets or honestly labeled placeholders,
+editable source for whatever may change, local media and fonts, and a project
+that opens. Check that yourself:
```bash
npx hyperframes check
npx hyperframes preview
```
-Then review the actual movement in [Studio](/studio), not only the design stills.
+Then watch it move in [Studio](/studio) β stills cannot show timing.
## Related topics
diff --git a/docs/guides/faceless-explainer.mdx b/docs/guides/faceless-explainer.mdx
index 70665d2fcf..03800be910 100644
--- a/docs/guides/faceless-explainer.mdx
+++ b/docs/guides/faceless-explainer.mdx
@@ -4,20 +4,19 @@ sidebarTitle: "Faceless explainer"
description: "Turn notes, an article, or a difficult idea into a visual explanation without product footage."
---
+import { DocsVideo } from "/snippets/docs-video.jsx";
+
Start from a topic, article, or notes. HyperFrames invents the typography, diagrams, abstract graphics, and data visualization that teach it.
-
-
-
+
+
+
+Kinetic type, an abstract graphic, a diagram, and a data-visualisation β all
+invented from the text. There is no source video anywhere in this.
## Make the request
diff --git a/docs/guides/figma.mdx b/docs/guides/figma.mdx
index e2c45f6b2e..cc5956be2e 100644
--- a/docs/guides/figma.mdx
+++ b/docs/guides/figma.mdx
@@ -3,10 +3,22 @@ title: Figma integration
description: "Bring Figma designs into HyperFrames β frozen assets, brand tokens, editable components, storyboard reconstruction, and Figma Motion timelines translated to GSAP."
---
+import { DocsVideo } from "/snippets/docs-video.jsx";
+
Import the parts of a Figma design that should survive into the project: assets,
brand values, editable components, motion, or storyboard states. HyperFrames
stores the result locally so the render does not depend on Figma.
+
+
+The same cursor and the same clicks land on both panels. Only the imported side
+responds β the field takes text, the button runs its states. One side is pixels,
+the other is a component.
+
## What you can import
| Capability | What you get | Surface |
diff --git a/docs/guides/gsap-animation.mdx b/docs/guides/gsap-animation.mdx
index 32dc2c4dd6..0e555b00d2 100644
--- a/docs/guides/gsap-animation.mdx
+++ b/docs/guides/gsap-animation.mdx
@@ -4,8 +4,21 @@ sidebarTitle: "GSAP animation"
description: "Create a paused timeline that HyperFrames can seek to any frame."
---
+import { DocsVideo } from "/snippets/docs-video.jsx";
+
GSAP is the primary animation runtime for HyperFrames compositions. You author the motion; HyperFrames owns the playhead.
+
+
+
+The code in that clip is the real thing β a `gsap.to()` with a `keyframes` array,
+and the same motion being reshaped by dragging the ease curve in Studio rather
+than guessing numbers.
+
## Minimal contract
Give the composition a finite duration, create a paused timeline, and register it under the composition ID:
diff --git a/docs/guides/hdr.mdx b/docs/guides/hdr.mdx
index 93e2d75d94..bc9cfda014 100644
--- a/docs/guides/hdr.mdx
+++ b/docs/guides/hdr.mdx
@@ -3,8 +3,21 @@ title: Render HDR video
description: Preserve BT.2020 PQ or HLG sources in a 10-bit H.265 MP4.
---
+import { DocsVideo } from "/snippets/docs-video.jsx";
+
HyperFrames detects HDR media during render. When an MP4 project contains a BT.2020 PQ or HLG source, the output uses 10-bit H.265 and keeps the HDR signal. Projects without HDR media stay SDR.
+
+
+
+You are reading this on an SDR screen, so nothing above can show you HDR
+brightness β and it does not try. It shows the `ffprobe` verdict on a real render
+and a brightness round-trip: 4000 nits authored, 4012 measured back out.
+
## Render and verify
```bash
diff --git a/docs/guides/html-in-canvas.mdx b/docs/guides/html-in-canvas.mdx
index fb2ce6a715..ca180ce384 100644
--- a/docs/guides/html-in-canvas.mdx
+++ b/docs/guides/html-in-canvas.mdx
@@ -3,10 +3,22 @@ title: "HTML in Canvas"
description: "Use live DOM content as a texture for WebGL and canvas effects."
---
+import { DocsVideo } from "/snippets/docs-video.jsx";
+
HTML in Canvas uses Chrome's experimental `drawElementImage()` API to copy rendered DOM content into a canvas. That canvas can become a Three.js texture or the input to a shader effect.
Use it when the visual treatment depends on both real HTML and GPU effectsβfor example, an interface inside a 3D device or a DOM scene passing through a distortion shader. It is an advanced, browser-dependent technique.
+
+
+The left panel is ordinary HTML and CSS. The right is the same pixels inside a
+WebGL scene β bent and lit by a shader, while the DOM underneath keeps changing
+and the texture re-captures every frame.
+
## Start with a proven block
The fastest path is to install a Catalog block that already handles capability detection and fallback behavior:
diff --git a/docs/guides/hyperframes-vs-remotion.mdx b/docs/guides/hyperframes-vs-remotion.mdx
index 8dc8073f65..7605e0099a 100644
--- a/docs/guides/hyperframes-vs-remotion.mdx
+++ b/docs/guides/hyperframes-vs-remotion.mdx
@@ -1,103 +1,165 @@
---
title: "HyperFrames or Remotion?"
-description: "A practical comparison of HTML-first HyperFrames and React-first Remotion."
+description: "The same three-second title card written in Remotion React and in HyperFrames HTML, plus an honest read on which tool fits your project."
---
-Both tools create videos with web technology and render them through a browser. The main difference is the authoring model.
+Both tools make video out of web pages. Both open a real browser, draw each
+frame, and encode the result. The difference is what you write.
-- **HyperFrames** treats HTML, CSS, and browser animation as the composition.
-- **Remotion** treats React components and frame-based React code as the composition.
+Remotion asks for a React component. HyperFrames asks for an HTML file.
-Neither choice is universally better. Pick the one that fits the source material, team, and workflow.
+Here is the same three seconds β a title that fades in, holds, and fades out β
+written both ways. Neither version is padded or crippled to make a point.
-## At a glance
+## The same title card, twice
-| Question | HyperFrames | Remotion |
+**Remotion.** The component is a function of the current frame number. You do
+the timing math yourself, in frames.
+
+```tsx
+import { AbsoluteFill, interpolate, useCurrentFrame } from "remotion";
+
+export const TitleCard = () => {
+ const frame = useCurrentFrame();
+
+ // fade in over frames 0-15, hold to 75, fade out by 90
+ const opacity = interpolate(frame, [0, 15, 75, 90], [0, 1, 1, 0], {
+ extrapolateLeft: "clamp",
+ extrapolateRight: "clamp",
+ });
+
+ return (
+
+
HELLO
+
+ );
+};
+```
+
+A `` entry in another file registers it as 90 frames at 30fps,
+1280Γ720.
+
+**HyperFrames.** The markup declares when things are on screen. A GSAP timeline
+declares how they move. Both live in one file.
+
+```html
+
+
+
+
+
HELLO
+
+
+
+
+
+```
+
+That is the whole file apart from `` boilerplate. Three rules make it
+render: every visible slot carries `class="clip"` with an `id`, `data-start`,
+`data-duration`, and `data-track-index`; the timeline is created **paused**; and
+it is registered on `window.__timelines` under the same id as the root element.
+Miss the last one and you get a still frame with no motion. The
+[HTML schema](/reference/html-schema) lists every attribute.
+
+{/* VISUAL: side-by-side stills of both renders of this title card. No approved asset exists yet β do not add a URL until one does. */}
+
+Neither file is obviously better. The Remotion one is a pure function you can
+reason about in your head. The HyperFrames one is a page you can open in a
+browser and inspect with devtools.
+
+## Where they actually differ
+
+| | HyperFrames | Remotion |
| --- | --- | --- |
-| Main authoring surface | HTML, CSS, and JavaScript | React and TypeScript |
-| Agent workflow | Built around agent skills and plain HTML projects | Provides agent skills and React video workflows |
-| Visual editing | HyperFrames Studio edits the rendered DOM and project source | Remotion Studio can edit and animate React compositions visually, then save changes back to code |
-| Existing web material | Can often be used directly or adapted as HTML | Usually translated into React components |
-| Animation model | Seeks registered browser timelines frame by frame | Commonly derives visuals from the current frame in React |
-| Reuse | HTML scenes, components, and Catalog items | React components and the React ecosystem |
-| Cloud rendering | Local, hosted cloud, AWS Lambda, and other deployment paths | Mature AWS Lambda and server-rendering options |
-| License | Apache 2.0 | Custom license with free and paid eligibility rules |
+| What you write | HTML, CSS, and JavaScript | React and TypeScript |
+| How motion is timed | The renderer pauses your animation and *seeks* it β jumps it to an exact moment β before capturing each frame | Your code reads the frame number and returns the values for that frame |
+| Existing web material | HTML, CSS, and a GSAP or Lottie animation usually drop in close to as-is | Rewritten as React components |
+| License | [Apache 2.0](https://github.com/heygen-com/hyperframes/blob/main/LICENSE) | Its own license β free for individuals and companies up to three people, paid above that. Check the [current terms](https://www.remotion.pro/license) |
-## Choose HyperFrames when
+The seeking model is the interesting one. Because HyperFrames drives the
+animation rather than watching a clock, GSAP, Web Animations, Lottie, and other
+browser runtimes render deterministically β the same frame comes out the same
+every time. See [Frame adapters](/concepts/frame-adapters) and
+[Deterministic rendering](/concepts/determinism).
-HyperFrames is a strong fit when:
+Both projects ship a visual editor and both save changes back to source.
+[HyperFrames Studio](/studio) edits the same DOM the renderer captures. Remotion
+Studio edits React compositions. They are not interchangeable, and neither
+replaces editing the source for real structural changes.
-- an AI agent will do most of the authoring;
-- the source is a website, HTML prototype, design artifact, or browser animation;
-- you want GSAP and other browser timelines to be seeked deterministically;
-- a human should review and edit the same DOM the renderer consumes;
-- Apache 2.0 licensing matters;
-- you want a project that can remain mostly plain HTML.
+Both render on AWS Lambda. HyperFrames also renders locally, on HeyGen's hosted
+cloud, and on Google Cloud Run β see [rendering paths](/deploy/overview).
-The main tradeoff is ecosystem maturity. HyperFrames is newer, and some advanced deployment and integration surfaces have less history than Remotionβs.
+## What Remotion does better
-## Choose Remotion when
+Say this plainly, because it matters if you are choosing today.
-Remotion is a strong fit when:
+Remotion is older and much more established. It has more templates, more
+tutorials, more answered questions, and far more production history. Remotion
+Lambda in particular is a mature, heavily documented rendering system; ours is
+newer.
-- your team already builds in React and TypeScript;
-- you want to reuse React components and tooling;
-- frame-driven React code is a natural way to express the animation;
-- you depend on Remotionβs established templates, community, or production infrastructure;
-- its mature Lambda ecosystem is important;
-- your organization is comfortable with its current license.
+If your team already writes React, Remotion gives you your components, your
+design system, your charting libraries, and typed, validated composition inputs
+for free. Nothing to translate.
-The main tradeoff is translation. Existing HTML, imperative browser animation, or a non-React design artifact may need to be adapted into Reactβs model.
+And its model is genuinely simpler to hold in your head. One pure function of
+the frame number, no timeline to register, no contract to get subtly wrong.
+HyperFrames asks you to follow rules β paused timeline, no wall clocks, no
+unseeded randomness β and breaks quietly if you don't.
-## Animation is the deepest technical difference
+## What HyperFrames does better
-Remotion compositions commonly calculate visual state from the current frame. This is explicit and works naturally with React.
+You do not need React, a build step, or a component rewrite. A website, an HTML
+prototype, an exported design, or an existing browser animation is already
+close to a composition.
-HyperFrames can also use frame-derived logic, but its distinctive path is a **frame adapter**: the renderer pauses a browser animation timeline and seeks it to the exact output time before capturing the frame.
+It is built for an AI agent to author. The [agent skills](/guides/skills)
+encode the framework's rules, so the agent writes valid compositions instead of
+guessing, and a human can then edit the same file in Studio.
-That makes GSAP, Web Animations, Lottie, and other supported browser runtimes usable without letting their wall clock control the render.
+And Apache 2.0 means no seat count and no license review.
-See [Frame adapters](/concepts/frame-adapters) and [Deterministic rendering](/concepts/determinism).
+## Moving a Remotion project across
-## Studio works differently
+There is a real migration path, not a promise. Install the skill:
-HyperFrames Studio selects and edits elements in the live composition DOM. It includes Storyboard and Preview views, direct canvas editing, layers, a timeline, animation controls, assets, captions, variables, source files, lint handoff, and export.
+```bash
+npx skills add heygen-com/hyperframes --skill remotion-to-hyperframes --full-depth
+```
-That does not mean every structural change should be made visually. Broader story and source changes are often better handled by the agent.
+Then ask your agent to port the composition. It maps `useCurrentFrame` and
+`interpolate` onto timeline tweens, `Sequence` onto clips, and converts frames
+to seconds. Roughly 80% of a typical composition translates mechanically.
-Remotion Studio is a development and visual-editing environment for React compositions. It supports direct manipulation and animation controls, then saves the result back to React code. Remotion also publishes tooling for building custom editing applications.
+The other 20% is the point of the skill. It refuses to translate what does not
+fit: React state machines built on `useState` or `useEffect`, async metadata,
+third-party React UI libraries. Those get flagged instead of silently
+mistranslated. It also grades its own output β it renders both versions and
+compares them frame by frame, and it writes down anything it dropped.
-The two Studios are not interchangeable. HyperFrames Studio operates on the DOM and HTML project that HyperFrames renders; Remotion Studio operates on React compositions.
-
-## Rendering and deployment
-
-Remotion Lambda is a mature distributed-rendering system with extensive AWS documentation.
-
-HyperFrames supports local rendering, HeyGen-hosted cloud rendering, AWS Lambda, Google Cloud Run, and custom deployment. The right comparison depends on the destination, expected volume, and how much infrastructure the team wants to operate.
-
-See [HyperFrames deployment](/developers) and [Remotion Lambda](https://www.remotion.dev/docs/lambda).
-
-## Licensing
-
-HyperFrames is available under the [Apache 2.0 license](https://github.com/heygen-com/hyperframes/blob/main/LICENSE).
-
-Remotion uses its own license. Its current terms allow free use for individuals and companies of up to three people, with a Company License required for larger organizations. Pricing and eligibility can change, so check the [official Remotion license page](https://www.remotion.pro/license) instead of relying on a copied price here.
-
-## Moving an existing project
-
-Do not migrate only because one framework looks newer. First identify what the current project depends on:
-
-- React components and React-specific libraries;
-- imperative browser animation;
-- cloud-rendering infrastructure;
-- visual editing;
-- licensing;
-- team familiarity.
-
-If a Remotion composition is a good candidate for HyperFrames, ask `/hyperframes` to route the work through the Remotion-to-HyperFrames migration workflow. Validate the result scene by scene; source migration is not a mechanical file conversion.
+Migrate because your source material or your team fits better on this side. Not
+because one framework looks newer.
## Related topics
-- [Understand the HyperFrames project model](/concepts)
+- [How a HyperFrames composition works](/concepts/compositions)
+- [Install and use the agent skills](/guides/skills)
- [Choose a rendering path](/deploy/overview)
-- [Build on HyperFrames](/developers)
diff --git a/docs/guides/mcp.mdx b/docs/guides/mcp.mdx
index f960d48c67..f260d3dfa3 100644
--- a/docs/guides/mcp.mdx
+++ b/docs/guides/mcp.mdx
@@ -3,6 +3,8 @@ title: "Create through an AI chat"
description: "Use the hosted HyperFrames MCP connector to create and render without installing the local CLI."
---
+import { DocsVideo } from "/snippets/docs-video.jsx";
+
HyperFrames MCP is a hosted connector for supported AI chat products. It lets
the chat call HyperFrames creation and rendering tools through your HeyGen
account without installing the local CLI.
@@ -12,6 +14,16 @@ account without installing the local CLI.
can change.
+
+
+An illustration of the flow, labelled as such on screen β describe the video,
+revise it in plain language, ask for the format you need, and the render comes
+back. Nothing is installed locally.
+
## Choose hosted or local
Use the hosted connector when you want:
diff --git a/docs/guides/media-effects.mdx b/docs/guides/media-effects.mdx
index b2756c6d19..e6fd918ce4 100644
--- a/docs/guides/media-effects.mdx
+++ b/docs/guides/media-effects.mdx
@@ -1,66 +1,86 @@
---
title: "Apply media effects"
sidebarTitle: "Media effects"
-description: "Apply editable blur, bloom, retro, print, glitch, and art treatments to images and video."
+description: "Turn an image or video into ASCII, halftone print, tape damage, CRT, painted art, and more β without touching the original file."
---
-Media effects transform a selected image or video without baking a new source
-file. They stay editable in Studio and render from the same project data.
+import { DocsVideo } from "/snippets/docs-video.jsx";
-
+An effect changes how a photo or video **looks**, not what it is. The file on
+disk never changes. You can adjust the effect later, animate it, or take it off
+entirely.
+
+Here is the whole range on real footage:
+
+
+
+Eighteen effects, sixteen color looks and four LUT paths β all on a single media
+layer, and all still editable afterwards.
+
+## What each family is for
+
+**Essentials β Blur, Pixelate, Bloom.**
+Hide something, pull focus onto something else, or make bright areas glow.
+
+**Retro and glitch β Tape Damage, Film Artifacts, Scanlines, CRT Curvature,
+Channel Separation, Digital Glitch, Chroma Softening.**
+Make footage look like old tape, old film, an old monitor, or a broken signal.
+The damage is built to behave like the real thing β tracking wobble, color
+bleed and tearing β not random colored noise.
+
+**Print β Halftone, Two-Ink Print, Ordered Dither, Mono Screen.**
+Turn the picture into printed dots or a two-color poster.
+
+**Art β ASCII, Engraving, Crosshatch, Kuwahara Paint.**
+Redraw the picture as text characters, engraved lines, hatching or paint. ASCII
+alone has eight styles, not one switch.
+
+
-## Choose the effect
+For grain and darkened edges, use Grain and Vignette in
+[Color grading](/guides/color-grading). For a HUD, light leak or flash, use a
+[Catalog overlay](/catalog).
-| Intent | Start with |
-| ------------------------------------------------------- | ---------------------------------- |
-| Soften, conceal, or lift bright areas | Blur, Pixelate, or Bloom |
-| Add tape, film, CRT, or digital damage | Retro & Glitch |
-| Turn media into dots, ink, or a limited palette | Print |
-| Create ASCII, engraving, crosshatch, or painted media | Art |
-| Add grain or darkened edges | Grain or Vignette in Color Grading |
-| Add a HUD, light leak, flash, or freeze-frame treatment | A [Catalog](/catalog) overlay |
+## Try one in Studio
-Effects apply to the complete selected media element. They do not track a face,
-screen, or object. Isolate a region into its own cropped or masked media layer
-when only that region should change.
+Select an image or video, then open **Effects** in the Inspector. Pick one
+effect, adjust it, and play the clip all the way through β some effects only
+look wrong once things move.
-## Try effects in Studio
+An effect covers the whole media layer. It does not follow a face, a screen or
+an object. If only part of the frame should change, crop or mask that part into
+its own layer first.
-Select an image or video and open **Effects** in the Inspector. The effect
-browser is grouped into:
+Blur, Bloom and Kuwahara Paint are the expensive ones. Several of them stacked
+across large layers will slow down both preview and rendering.
-- **Essentials:** Blur, Pixelate, Bloom
-- **Retro & Glitch:** Chroma Softening, Tape Damage, Film Artifacts, Scanlines,
- CRT Curvature, Channel Separation, Digital Glitch
-- **Print:** Halftone, Two-Ink Print, Ordered Dither, Mono Screen
-- **Art:** ASCII, Engraving, Crosshatch, Kuwahara Paint
+## Or just ask the agent
-Choose one effect for the job, adjust its controls, then play or scrub the
-beginning, middle, and end. Some effects are much more expensive to render than
-others, especially Blur, Bloom, and Kuwahara Paint across large media layers.
-
-## Ask the agent
-
-Describe the result instead of guessing control values:
+Describe what you want it to look like. You do not need to know the control
+names:
```text
Make this product clip feel like a clean two-ink editorial print.
Keep the product shape and label readable.
```
-The agent can inspect the live capability catalog before editing:
+The agent can look up what is available before it changes anything:
```bash
npx hyperframes media-treatment --capabilities --json
npx hyperframes media-treatment --capability twoInkPrint --json
```
-Then it can apply a validated patch:
+Then apply it:
```bash
npx hyperframes media-treatment \
@@ -69,37 +89,31 @@ npx hyperframes media-treatment \
--apply --json
```
-Use `--dry-run` to inspect the exact mutation without writing, `--analyze` for
-bounded source measurements and a suggested primary correction, or `--clear`
-to remove the selected treatment. The command writes the same
-`data-color-grading` contract that Studio uses.
+Add `--dry-run` to see the change without writing it, `--analyze` to measure the
+source first, or `--clear` to take an effect off. This writes the same
+`data-color-grading` data that Studio reads, so the two never disagree.
-## Keep the treatment useful
+## Keeping it useful
-- Use blur or pixelation for a real reveal, focus shift, or privacy need.
-- Use a named stylization strongly enough to read; keep ordinary correction
- restrained.
-- Compare against the original and inspect representative rendered frames.
-- Remove the treatment when it competes with the story.
+Use blur or pixelation when you actually mean to hide or reveal something. If
+you pick a strong look, commit to it β a half-strength ASCII just reads as a
+mistake. Compare against the original, and take the effect off when it starts
+competing with the story.
-## Performance and delivery
+## Two limits worth knowing
-Several overlapping, full-frame treated layers can slow preview and rendering,
-especially at 4K. Simplify the stack or pre-render a finished layer when
-playback drops frames.
+**HDR.** Effects run on the standard (SDR) pipeline. A native HDR layer keeps
+its HDR pixels through a separate path, so these effects will not appear on it.
+Convert to SDR if the effect has to survive into the final file.
-Effects use the SDR/Rec.709 shader pipeline. Native HDR delivery preserves HDR
-source pixels through a separate path, so these SDR effects do not appear on
-native HDR layers. Convert or tone-map to SDR when the effect must appear in
-the final result.
+**Remote files.** Keep media inside the project. A file loaded from another
+server only works if that server sends the right CORS headers, and it can
+disappear between now and render time.
-Project-local media is the reliable default. Remote media must allow browser
-pixel access through compatible CORS headers.
-
-The [Color Grading guide](/guides/color-grading) covers correction, wheels,
-curves, selective color, finishing, and LUTs. The [HTML
-schema](/reference/html-schema#color-grading-and-media-effects) contains the
-persistence contract.
+The [Color grading guide](/guides/color-grading) covers correction, curves,
+selective color and LUTs. The
+[HTML schema](/reference/html-schema#color-grading-and-media-effects) has the
+exact data format.
## Related topics
diff --git a/docs/guides/media.mdx b/docs/guides/media.mdx
index bef39fee72..3e13dae9ed 100644
--- a/docs/guides/media.mdx
+++ b/docs/guides/media.mdx
@@ -4,10 +4,21 @@ sidebarTitle: "Overview"
description: "Use footage, images, audio, captions, backgrounds, and color in a HyperFrames project."
---
+import { DocsVideo } from "/snippets/docs-video.jsx";
+
Media can come from your project, a captured website, an upload, or a generated
asset. Put anything required for the final result inside the project so preview
and rendering use the same file.
+
+
+Each step adds one attribute on the left and shows the result on the right. The
+last one swaps the file entirely β everything else about the scene stays put.
+
## Start with the role, not the effect
| Media | Give it one main job |
diff --git a/docs/guides/motion-graphics.mdx b/docs/guides/motion-graphics.mdx
index b1f7b7ce93..bf33c1eb0c 100644
--- a/docs/guides/motion-graphics.mdx
+++ b/docs/guides/motion-graphics.mdx
@@ -8,13 +8,15 @@ import { DocsVideo } from "/snippets/docs-video.jsx";
Use Motion Graphics for one short, design-led ideaβusually under ten secondsβwhere the movement carries the message.
-
-
-
+
+
+
+Short beats back to back, because that is what this workflow makes β units of
+motion small enough to drop into something else.
## Make the request
@@ -61,6 +63,20 @@ For an overlay, name where it should sit and how long it should hold. The first
Check the motion at full speed, render the chosen format, and review the final file.
+## A finished one, end to end
+
+The demo above shows the range. This is a complete graphic built from it β
+music and sound, no narration, the motion carrying all of it.
+
+
+
+
+
+
## Related topics
- [Prompt for motion graphics](/prompting/motion-graphics)
diff --git a/docs/guides/music-to-video.mdx b/docs/guides/music-to-video.mdx
index 068a4250de..94b1c00a99 100644
--- a/docs/guides/music-to-video.mdx
+++ b/docs/guides/music-to-video.mdx
@@ -11,7 +11,7 @@ Start with a music fileβor a video whose audio should control the edit. Narrat
diff --git a/docs/guides/performance.mdx b/docs/guides/performance.mdx
index a2885f83b8..e99a803441 100644
--- a/docs/guides/performance.mdx
+++ b/docs/guides/performance.mdx
@@ -3,8 +3,20 @@ title: Fix a slow preview or render
description: Find the expensive part of a composition and make it cheaper.
---
+import { DocsVideo } from "/snippets/docs-video.jsx";
+
A finished render can be smooth even when preview stutters. Preview must draw each frame in real time; render can take as long as it needs to capture the same frames.
+
+
+Real numbers, not estimates: 25.0s against 9.8s, taken as the median of three
+runs at 1920x1080 over 300 frames. One CSS declaration is the whole difference,
+and a pixel comparison confirms the picture did not change.
+
## Start with the symptom
| What you see | Check first |
diff --git a/docs/guides/product-launch-video.mdx b/docs/guides/product-launch-video.mdx
index 199d164222..dab22bd966 100644
--- a/docs/guides/product-launch-video.mdx
+++ b/docs/guides/product-launch-video.mdx
@@ -8,13 +8,15 @@ import { DocsVideo } from "/snippets/docs-video.jsx";
Give HyperFrames the real URL when the product, website, or brand should appear in the result.
-
-
-
+
+
+Built by running this workflow on a real site. The screens are captured from
+huly.io, not mocked β which is the point: you give it a URL and it works from
+what is actually there.
## Make the request
diff --git a/docs/guides/remove-background.mdx b/docs/guides/remove-background.mdx
index cc5d2ff49c..deb8d91236 100644
--- a/docs/guides/remove-background.mdx
+++ b/docs/guides/remove-background.mdx
@@ -3,6 +3,8 @@ title: "Remove a background"
description: "Turn footage of a person or a portrait image into transparent media you can layer over a HyperFrames scene."
---
+import { DocsVideo } from "/snippets/docs-video.jsx";
+
Use background removal when a person needs to appear over designed text,
graphics, or another scene. HyperFrames runs the included human-segmentation
model locally; it does not upload the source or require an API key.
@@ -14,6 +16,16 @@ model locally; it does not upload the source or require an API key.
/>
+
+
+
+Every frame is real CLI output. The magnified panels sit on the hair edge and on
+a shoulder a plant used to overlap, because those are where matting usually fails.
+
## Create the transparent file
Make sure FFmpeg is installed, then run:
diff --git a/docs/guides/rendering.mdx b/docs/guides/rendering.mdx
index a13246162b..68716faaeb 100644
--- a/docs/guides/rendering.mdx
+++ b/docs/guides/rendering.mdx
@@ -3,8 +3,20 @@ title: "Render from the command line"
description: "Check a project and render MP4, MOV, WebM, GIF, or PNG output."
---
+import { DocsVideo } from "/snippets/docs-video.jsx";
+
Studio is the simplest place to export a project. Use the command line when an agent, script, CI job, or advanced delivery workflow needs to control the render.
+
+
+The whole loop: the project, the render command, progress, and the finished file
+playing. The flags shown are the ones people actually reach for β format,
+resolution, frame rate, quality.
+
## Render a normal video
From the project folder:
diff --git a/docs/guides/skills.mdx b/docs/guides/skills.mdx
index b0777b322a..0d60efa6f5 100644
--- a/docs/guides/skills.mdx
+++ b/docs/guides/skills.mdx
@@ -4,8 +4,20 @@ sidebarTitle: "Agent skills"
description: "Teach a coding agent how to create valid HyperFrames projects and load specialized workflows when needed."
---
+import { DocsVideo } from "/snippets/docs-video.jsx";
+
HyperFrames skills teach coding agents the project format, animation rules, media workflow, validation loop, and creation workflows that generic web knowledge does not cover.
+
+
+The terminal output is a real run of the command. Afterwards the router reads a
+request and chooses the workflow for it, instead of the agent guessing at the
+framework's rules.
+
## Install for a person
Run the interactive installer:
diff --git a/docs/guides/slideshow.mdx b/docs/guides/slideshow.mdx
index e6617ff9af..f57ee2f678 100644
--- a/docs/guides/slideshow.mdx
+++ b/docs/guides/slideshow.mdx
@@ -4,20 +4,21 @@ sidebarTitle: "Presentation"
description: "Build a navigable deck with reveals, notes, optional branches, hotspots, and presenter mode."
---
+import { DocsVideo } from "/snippets/docs-video.jsx";
+
A HyperFrames slideshow stays interactive. The result is a live, navigable deckβnot a linear MP4.
-
-
-
+
+
+
+This is a live capture of a running deck, not a video of slides. Watch the
+fragments arrive one key-press at a time, a hotspot jump to a branch slide, the
+back control return to the exact fragment it left, and presenter mode open with
+real speaker notes and a running timer.
## Make the request
@@ -32,7 +33,17 @@ The agent confirms the audience, main outcome, and whether the deck needs
reveals, optional branches, or presenter notes. You do not need to prescribe
every slide before seeing the proposed structure.
-If the result should play from beginning to end without a presenter, use a normal [video workflow](/workflows). A slideshow cannot currently be exported as one complete linear MP4; per-slide snapshots are supported.
+If the result should play from beginning to end without a presenter, use a normal [video workflow](/workflows). A slideshow cannot be exported as one linear MP4 yet.
+
+
+ Do not run `hyperframes render` on a deck. It does not fail β a deck has no
+ master root composition, so the render resolves only the **first** slide and
+ writes a silently truncated MP4. You can get six seconds of a forty-second
+ deck and no warning that anything is missing.
+
+ Use `hyperframes present` for the live deck, or `hyperframes snapshot` for
+ per-slide stills.
+
## What control does the presenter need?
diff --git a/docs/guides/video-components.mdx b/docs/guides/video-components.mdx
index 4302e21ad3..1168cc369c 100644
--- a/docs/guides/video-components.mdx
+++ b/docs/guides/video-components.mdx
@@ -4,20 +4,20 @@ sidebarTitle: "Images and video"
description: "Import, place, replace, trim, and review images and footage in a HyperFrames project."
---
+import { DocsVideo } from "/snippets/docs-video.jsx";
+
Images and footage should enter the project once, remain easy to identify, and
behave the same in preview and the final render.
-
-
-
+
+
+
+Each step adds one attribute and shows the result. The last swaps the source
+file; the crop, timing and placement around it stay exactly as they were.
## Import a file
@@ -72,6 +72,25 @@ Continue to [Use Assets and Catalog](/studio/assets-and-blocks) for the Studio
controls, or [Media effects](/guides/media-effects) when the source needs a
non-destructive visual treatment.
+## The same edits in Studio
+
+Everything above is done by editing attributes by hand. Studio writes the
+same attributes when you drag, trim or reframe β it is the other way into
+one file, not a second copy of the project.
+
+
+
+
+
+
## Related topics
- [Use Assets and Catalog in Studio](/studio/assets-and-blocks)
diff --git a/docs/guides/voice-and-audio.mdx b/docs/guides/voice-and-audio.mdx
index b5c6404763..3fca39fc14 100644
--- a/docs/guides/voice-and-audio.mdx
+++ b/docs/guides/voice-and-audio.mdx
@@ -17,13 +17,15 @@ understand or feel the video.
| Sound effects | Reinforce a specific action or transition |
| Captions | Make spoken words readable and searchable on screen |
-
-
-
+
+
+
+Turn the sound on for this one β the audio is the subject. You can watch the
+music duck as narration arrives and see each effect land against the waveform.
## Create a voiceover
diff --git a/docs/introduction.mdx b/docs/introduction.mdx
index e05660e4b0..8c406b9502 100644
--- a/docs/introduction.mdx
+++ b/docs/introduction.mdx
@@ -9,7 +9,7 @@ import { DocsVideo, ShowcaseWall } from "/snippets/docs-video.jsx";
diff --git a/docs/packages/cli.mdx b/docs/packages/cli.mdx
index 387f34cd20..d5ad5dd98c 100644
--- a/docs/packages/cli.mdx
+++ b/docs/packages/cli.mdx
@@ -4,75 +4,48 @@ sidebarTitle: "CLI reference"
description: "Create, preview, and render HTML video compositions from the command line."
---
-The `hyperframes` CLI is the primary way to work with HyperFrames. It handles project creation, live preview, rendering, linting, and diagnostics β all from your terminal.
+This page lists every command and every flag. If you are still deciding which
+command you need, the [CLI guide](/developers/cli) is the shorter route.
+
+The installed version is always the authority. Run
+`npx hyperframes --help` to see exactly what your copy accepts.
```bash
-npm install -g hyperframes
-# or use directly with npx
+# No install needed
npx hyperframes
+
+# Or install once
+npm install -g hyperframes
```
-## When to Use
+## Find your command
-**Use the CLI when you want to:**
+| You want to | Use |
+| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Start a project | [`init`](#init), [`add`](#add), [`catalog`](#catalog) |
+| Bring in source material | [`capture`](#capture), [`transcribe`](#transcribe), [`tts`](#tts), [`remove-background`](#remove-background), [`media-treatment`](#media-treatment), [`beats`](#beats) |
+| Look at it, or share it | [`preview`](#preview), [`present`](#present-and-play), [`play`](#present-and-play), [`publish`](#publish) |
+| Find problems | [`lint`](#lint), [`check`](#check), [`snapshot`](#snapshot), [`keyframes`](#keyframes), [`compare`](#compare-and-grade-compare), [`grade-compare`](#compare-and-grade-compare) |
+| Make a file | [`render`](#render), [`benchmark`](#benchmark) |
+| Render somewhere else | [`cloud`](#hyperframes-cloud), [`lambda`](#hyperframes-lambda), [`cloudrun`](#hyperframes-cloudrun) |
+| Fix your setup | [`doctor`](#doctor), [`browser`](#browser), [`upgrade`](#upgrade), [`docs`](#docs), [`info`](#info-and-compositions), [`compositions`](#info-and-compositions) |
+| Connect other tools | [`auth`](#hyperframes-auth), [`skills`](#skills), [`figma`](#figma-and-events), [`telemetry`](#telemetry), [`feedback`](#feedback) |
-- Capture a website for video production (`capture`)
-- Create a new composition project from an example (`init`)
-- Preview compositions with live hot reload (`preview`)
-- Render compositions to MP4 locally or in Docker (`render`)
-- Lint compositions for structural issues (`lint`)
-- Inspect rendered visual layout for text overflow, clipped containers, and overlapping text, plus verify motion intent against the seeked timeline (`inspect`)
-- Capture key frames as PNG screenshots (`snapshot`)
-- Check your environment for missing dependencies (`doctor`)
+`validate`, `inspect`, and `layout` still work but are
+[deprecated](#deprecated-validate-inspect-and-layout). Use `check` instead.
-**Use a different package if you want to:**
+## What every command shares
-- Render programmatically from Node.js code β use the [producer](/packages/producer)
-- Build a custom frame capture pipeline β use the [engine](/packages/engine)
-- Embed a composition editor in your own web app β use the [studio](/packages/studio)
-- Parse or generate composition HTML in code β use [core](/packages/core)
+Read this once and skip the repetition below.
-
- The CLI is the recommended starting point for all HyperFrames users. It wraps the producer,
- engine, and studio packages so you do not need to install them separately.
-
+**The project directory.** Most commands take it as the first argument and
+default to the current directory: `npx hyperframes check ./my-video`. A few
+take it as a flag instead β `add`, `transcribe`, `feedback`, and `skills` use
+`--dir`.
-## Agent-Friendly by Default
-
-The CLI is **agent-friendly by default**: commands support explicit flags and parseable output so automation can run reliably.
-
-- Inputs can be passed via flags (for example, `--example`, `--video`, `--output`)
-- Missing required flags fail fast with a clear error and usage example
-- Output is plain text suitable for parsing
-
-Interactivity is command-specific. For example, `init` uses prompts on TTY by default; pass `--non-interactive` to force non-interactive mode.
-
-`--human-friendly` is also command-specific (for example, `catalog`). It is not a global flag on every command.
-
-
-
- ```bash
- # Fully non-interactive β all inputs from flags
- npx hyperframes init my-video --example blank --video video.mp4 --non-interactive
- npx hyperframes render --output output.mp4 --fps 30 --quality standard
- npx hyperframes upgrade --check --json
- ```
-
-
- ```bash
- # Command-specific interactive flow
- npx hyperframes init my-video
-
- # Interactive picker supported by catalog
- npx hyperframes catalog --human-friendly
- ```
-
-
-
-
-### JSON Output and `_meta` Envelope
-
-All commands that support `--json` wrap their output with a `_meta` field containing version check info:
+**`--json` for agents and scripts.** Almost every command accepts it. The
+payload is wrapped with a `_meta` field so a script can spot an outdated CLI
+from any command's output, without a second call:
```json
{
@@ -86,366 +59,121 @@ All commands that support `--json` wrap their output with a `_meta` field contai
}
```
-This allows agents to detect outdated versions from any command's output without running a separate upgrade check. The version data comes from a 24-hour cache β no network request is made during `--json` output.
+The version numbers come from a cache refreshed at most once a day. `--json`
+never makes a network request of its own. Deprecated commands add
+`_meta.deprecated: true`.
-### Passive Update Notices
+**Flags, not prompts.** A missing required flag fails immediately with a usage
+example rather than waiting for input. Two commands are interactive on a TTY:
+`init` prompts for a project name and example unless you pass
+`--non-interactive`, and `catalog --human-friendly` opens a picker. Nothing else
+prompts, apart from confirmations you can skip with `--yes` or `--no-confirm`.
-The CLI checks npm for newer versions in the background (cached 24 hours). If an update is available, a notice appears on stderr after command completion:
+**Version notices.** An owned install (npm, bun, pnpm, brew) updates itself
+quietly in the background and prints one line on the next run:
+`hyperframes auto-updated to v0.1.5`. It never crosses a major version. Anywhere
+it cannot install β `npx`, an unknown installer β you get a notice instead:
```
Update available: 0.1.4 β 0.1.5
Run: npx hyperframes@latest
```
-This is suppressed in CI environments, non-TTY shells, and when `HYPERFRAMES_NO_UPDATE_CHECK=1` is set.
+Both stay silent in CI and non-TTY shells. `HYPERFRAMES_NO_UPDATE_CHECK=1` turns
+off the check, the install, and the notice.
-## Getting Started
-
-
-
- Scaffold a new composition from an example:
- ```bash
- npx hyperframes init --example warm-grain
- ```
- You will be prompted for a project name, or pass it as an argument:
- ```bash
- npx hyperframes init my-video --example warm-grain
- ```
- See [Examples](/examples) for all available examples.
-
-
- Start the development server with live hot reload:
- ```bash
- cd my-video
- npx hyperframes preview
- ```
- The HyperFrames Studio opens in your browser. Edit `index.html` and the preview updates instantly.
-
-
- Check for structural issues before rendering:
- ```bash
- npx hyperframes lint
- ```
- ```
- β Linting my-project/index.html
-
- β 0 errors, 0 warnings
- ```
-
-
-
- Produce the final video:
- ```bash
- npx hyperframes render --output output.mp4
- ```
- Render a specific composition instead of `index.html`:
- ```bash
- npx hyperframes render -c compositions/intro.html -o intro.mp4
- ```
- For deterministic output, add `--docker`:
- ```bash
- npx hyperframes render --docker --output output.mp4
- ```
-
-
-
-## Commands
-
-The installed version is authoritative: run `npx hyperframes --help` or
-`npx hyperframes --help`. The sections below document the commands
-used most often; deployment and integration commands link to their focused
-guides.
-
-| Job | Commands |
-| ------------------------ | -------------------------------------------------------------------------------------------- |
-| Start and build | `init`, `add`, `catalog`, `capture`, `preview`, `present` |
-| Check and inspect | `lint`, `check`, `snapshot`, `keyframes`, `compare`, `grade-compare`, `info`, `compositions` |
-| Render and share | `render`, `publish`, `cloud`, `lambda`, `cloudrun` |
-| Work with media | `media-treatment`, `transcribe`, `tts`, `remove-background`, `beats` |
-| Set up integrations | `skills`, `auth`, `figma` |
-| Maintain the environment | `browser`, `doctor`, `upgrade`, `feedback`, `telemetry`, `docs` |
-
-`validate`, `inspect`, and `layout` remain as compatibility commands. Prefer
-`check`, which combines lint, runtime, layout, motion, and contrast checks in
-one browser session.
-
-## Create and source material
+## Create a project
### `init`
-Create a new composition project from an example:
+Scaffold a new composition project from an example.
```bash
-# Non-interactive use
+# Agents and CI β every input from a flag
npx hyperframes init my-video --example blank --video video.mp4 --non-interactive
-# Include Tailwind CSS browser-runtime support
+# With the Tailwind browser runtime
npx hyperframes init my-video --example blank --tailwind
-# Human mode β interactive prompts on TTY by default
+# Interactive on a TTY
npx hyperframes init my-video
```
| Flag | Description |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `--example, -e` | Example to scaffold; required in non-interactive mode |
+| `--example, -e` | Example to scaffold. Required with `--non-interactive`. See [Examples](/examples) for the full list. |
| `--resolution` | Canvas preset: `landscape` (1920Γ1080), `portrait` (1080Γ1920), `landscape-4k` (3840Γ2160), `portrait-4k` (2160Γ3840), `square` (1080Γ1080), `square-4k` (2160Γ2160). Aliases: `1080p`, `4k`, `uhd`, `1080p-square`, `square-1080p`, `4k-square`. Default: keep template dimensions. |
| `--video, -v` | Path to a video file (MP4, WebM, MOV) |
| `--audio, -a` | Path to an audio file (MP3, WAV, M4A) |
-| `--tailwind` | Add Tailwind CSS browser-runtime support to scaffolded HTML |
-| `--non-interactive` | Disable prompts for agents and CI |
-| `--skip-skills` | Temporarily ignored; set `HYPERFRAMES_SKIP_SKILLS=1` to opt out in CI or tests |
-| `--skip-transcribe` | Skip automatic whisper transcription |
-| `--model` | Whisper model for transcription (for example `small.en`, `medium.en`, or `large`) |
-| `--language` | Language code for transcription (e.g. `en`, `es`, `ja`). Filters non-target speech. |
+| `--tailwind` | Add Tailwind CSS browser-runtime support to the scaffolded HTML |
+| `--non-interactive` | Never prompt. For agents and CI. |
+| `--skip-transcribe` | Skip the automatic Whisper transcription |
+| `--model` | Whisper model for that transcription (for example `small.en`, `medium.en`, `large`) |
+| `--language` | Language code for transcription (`en`, `es`, `ja`, β¦). Filters out speech in other languages. |
+| `--skip-skills` | Currently ignored. Set `HYPERFRAMES_SKIP_SKILLS=1` to opt out in CI or tests. |
-| Example | Description |
-| ------------ | ---------------------------------------- |
-| `blank` | Empty composition β just the scaffolding |
-| `warm-grain` | Cream aesthetic with grain texture |
-| `play-mode` | Playful elastic animations |
-| `swiss-grid` | Structured grid layout |
-| `vignelli` | Bold typography with red accents |
+Pass `--video` or `--audio` and the CLI transcribes the audio with Whisper and
+patches the captions into the composition for you. `--skip-transcribe` turns
+that off.
-In non-interactive mode, `--example` is required β the CLI errors with a usage example if missing. In interactive mode (default on TTY), you choose the example interactively. Pass `--non-interactive` to require `--example` via flag. When `--video` or `--audio` is provided, the CLI automatically transcribes the audio with Whisper and patches captions into the composition (use `--skip-transcribe` to disable).
+`--tailwind` injects the pinned Tailwind v4 browser runtime and exposes a
+`window.__tailwindReady` promise that renders wait on before capturing frame 0.
+Use the `/hyperframes-core` skill when editing these projects, so agents follow
+v4 CSS-first patterns instead of v3 `tailwind.config.js` patterns. The browser
+runtime is meant for scaffolded projects and quick iteration β for offline or
+locked-down production renders, compile Tailwind to CSS and link the stylesheet.
-`--tailwind` injects the pinned Tailwind v4 browser runtime into scaffolded HTML and exposes a `window.__tailwindReady` promise that renders wait on before capturing frame 0. Use the `/hyperframes-core` skill when editing these projects so agents follow v4 CSS-first patterns instead of v3 `tailwind.config.js` and `@tailwind` directive patterns. The browser runtime is still intended for scaffolded projects and quick iteration; for fully offline or locked-down production renders, compile Tailwind to CSS and include the stylesheet directly.
-
-After scaffolding, the CLI checks and installs the core AI skills from the
-current GitHub source. Set `HYPERFRAMES_SKIP_SKILLS=1` only when CI or tests
-must opt out. See [`skills`](#skills).
-
-See [Examples](/examples) for full details.
+After scaffolding, `init` checks and installs the core AI skills from the
+current GitHub source. See [`skills`](#skills).
### `add`
-Install a **block** or **component** from the registry into an existing project. Examples (full projects) are scaffolded with [`init`](#init); blocks and components are smaller units you add to a composition you already have.
+Install one item from the registry into a project you already have.
+[`init`](#init) scaffolds whole projects; `add` drops in a **block** (a
+sub-composition scene) or a **component** (an effect or snippet).
```bash
-# Add a block (sub-composition scene)
-npx hyperframes add claude-code-window
-
-# Add a component (effect / snippet)
-npx hyperframes add shader-wipe
-
-# Target a different project dir
+npx hyperframes add claude-code-window # a block
+npx hyperframes add shader-wipe # a component
+npx hyperframes add captions # every block with this tag
npx hyperframes add shader-wipe --dir ./my-video
-
-# Headless / CI (skip clipboard; also: --json for a machine-readable result)
-npx hyperframes add shader-wipe --no-clipboard --json
+npx hyperframes add shader-wipe --no-clipboard --json # headless / CI
```
-| Flag | Description |
-| --------------------- | -------------------------------------------------------------------- |
-| `` (positional) | Registry item name (e.g. `claude-code-window`, `shader-wipe`) |
-| `--dir` | Project directory (defaults to the current working directory) |
-| `--no-clipboard` | Skip copying the include snippet to the clipboard |
-| `--json` | Print a machine-readable summary (written files + snippet) to stdout |
+The positional name is a registry item, or a tag β a tag installs every block
+carrying it. `--dir` picks the project directory, `--json` prints the written
+files and paste snippet, and `--no-clipboard` skips the clipboard copy for CI.
-`add` reads [`hyperframes.json`](#hyperframes-json) at the project root to know which registry to pull from and where to drop files. If the file is missing but the directory looks like a HyperFrames project (has `index.html`), a default `hyperframes.json` is written the first time you run `add`.
+Every install produces files plus a **paste snippet**: the `