heygen-com · ukimsanov · Aug 4, 2026 · Aug 3, 2026 · Aug 4, 2026 · Aug 4, 2026
diff --git a/.github/workflows/catalog-previews.yml b/.github/workflows/catalog-previews.yml
@@ -15,6 +15,9 @@ on:
       - "registry/blocks/**"
       - "registry/components/**"
       - "scripts/generate-catalog-previews.ts"
+      # The containment module the renderer imports. Without it a change to
+      # path-traversal defence alone never re-runs the job that exercises it.
+      - "scripts/registry-target-paths.mjs"
       - ".github/workflows/catalog-previews.yml"
 
 concurrency:

diff --git a/docs/catalog/blocks/app-showcase.mdx b/docs/catalog/blocks/app-showcase.mdx
@@ -3,23 +3,24 @@ title: "App Showcase"
 description: "Fitness app product showcase with three floating smartphone screens"
 ---
 
-# App Showcase
-
-Fitness app product showcase with three floating smartphone screens
-
 `showcase` `app` `3d`
 
 <video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/app-showcase.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/app-showcase.png" autoPlay muted loop playsInline />
 
-## Install
+## Add it to a project
 
-<CodeGroup>
+### Ask your agent
 
-```bash Terminal
-npx hyperframes add app-showcase
+```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.
 ```
 
-</CodeGroup>
+### Install from the terminal
+
+```bash
+npx hyperframes add app-showcase
+```
 
 ## Details
 
@@ -29,16 +30,24 @@ npx hyperframes add app-showcase
 | Dimensions | 1920×1080 |
 | Duration | 5.5s |
 
-## Files
+**Installed files**
 
 | File | Target | Type |
 | --- | --- | --- |
 | `app-showcase.html` | `compositions/app-showcase.html` | hyperframes:composition |
 
-## Usage
+## 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.
 
-After installing, add the block to your host composition:
+**Wiring it by hand.** The installed block can be added to a host composition with:
 
 ```html
 <div data-composition-id="app-showcase" data-composition-src="compositions/app-showcase.html" data-start="0" data-duration="5.5" data-track-index="1" data-width="1920" data-height="1080"></div>
 ```
+
+## Related topics
+
+- [Browse the complete Catalog](/catalog)
+- [Add assets and Catalog items in Studio](/studio/assets-and-blocks)
+- [Build a richer composition](/go-further)
diff --git a/docs/catalog/blocks/apple-money-count.mdx b/docs/catalog/blocks/apple-money-count.mdx
@@ -3,10 +3,6 @@ title: "Apple Money Count"
 description: "Apple-style finance counter that counts from $0 to $10,000, flashes green, and bursts money icons with sound."
 ---
 
-# Apple Money Count
-
-Apple-style finance counter that counts from $0 to $10,000, flashes green, and bursts money icons with sound.
-
 `showcase` `finance` `kinetic` `youtube` `sfx`
 
 Created by [Stronkter](https://x.com/Stronkter).
@@ -19,15 +15,20 @@ Created by [Stronkter](https://x.com/Stronkter).
 
 <video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/apple-money-count.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/apple-money-count.png" autoPlay muted loop playsInline />
 
-## Install
+## Add it to a project
 
-<CodeGroup>
+### Ask your agent
 
-```bash Terminal
-npx hyperframes add apple-money-count
+```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.
 ```
 
-</CodeGroup>
+### Install from the terminal
+
+```bash
+npx hyperframes add apple-money-count
+```
 
 ## Details
 
@@ -37,17 +38,25 @@ npx hyperframes add apple-money-count
 | Dimensions | 1920×1080 |
 | Duration | 5s |
 
-## Files
+**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 |
 
-## Usage
+## 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.
 
-After installing, add the block to your host composition:
+**Wiring it by hand.** The installed block can be added to a host composition with:
 
 ```html
 <div data-composition-id="apple-money-count" data-composition-src="compositions/apple-money-count.html" data-start="0" data-duration="5" data-track-index="1" data-width="1920" data-height="1080"></div>
 ```
+
+## Related topics
+
+- [Browse the complete Catalog](/catalog)
+- [Add assets and Catalog items in Studio](/studio/assets-and-blocks)
+- [Build a richer composition](/go-further)
diff --git a/docs/catalog/blocks/beat-freeze-cut.mdx b/docs/catalog/blocks/beat-freeze-cut.mdx
@@ -3,23 +3,24 @@ title: "Beat Freeze Cut"
 description: "A beat-driven speed ramp, freeze-frame hit, and hard-cut sequence for music-led promos and montages."
 ---
 
-# Beat Freeze Cut
-
-A beat-driven speed ramp, freeze-frame hit, and hard-cut sequence for music-led promos and montages.
-
 `transition` `music` `beat-driven` `freeze-frame`
 
 <video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/beat-freeze-cut.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/beat-freeze-cut.png" autoPlay muted loop playsInline />
 
-## Install
+## Add it to a project
 
-<CodeGroup>
+### Ask your agent
 
-```bash Terminal
-npx hyperframes add beat-freeze-cut
+```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.
 ```
 
-</CodeGroup>
+### Install from the terminal
+
+```bash
+npx hyperframes add beat-freeze-cut
+```
 
 ## Details
 
@@ -29,16 +30,24 @@ npx hyperframes add beat-freeze-cut
 | Dimensions | 1920×1080 |
 | Duration | 6s |
 
-## Files
+**Installed files**
 
 | File | Target | Type |
 | --- | --- | --- |
 | `beat-freeze-cut.html` | `compositions/beat-freeze-cut.html` | hyperframes:composition |
 
-## Usage
+## 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.
 
-After installing, add the block to your host composition:
+**Wiring it by hand.** The installed block can be added to a host composition with:
 
 ```html
 <div data-composition-id="beat-freeze-cut" data-composition-src="compositions/beat-freeze-cut.html" data-start="0" data-duration="6" data-track-index="1" data-width="1920" data-height="1080"></div>
 ```
+
+## Related topics
+
+- [Browse the complete Catalog](/catalog)
+- [Add assets and Catalog items in Studio](/studio/assets-and-blocks)
+- [Build a richer composition](/go-further)
diff --git a/docs/catalog/blocks/blue-sweater-intro-video.mdx b/docs/catalog/blocks/blue-sweater-intro-video.mdx
@@ -3,25 +3,26 @@ title: "Blue Sweater Intro Video"
 description: "Warm AI creator intro sequence that resolves into an X follow card for @_blue_sweater_."
 ---
 
-# Blue Sweater Intro Video
-
-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_).
 
 <video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/blue-sweater-intro-video.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/blue-sweater-intro-video.png" autoPlay muted loop playsInline />
 
-## Install
+## Add it to a project
 
-<CodeGroup>
+### Ask your agent
 
-```bash Terminal
-npx hyperframes add blue-sweater-intro-video
+```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.
 ```
 
-</CodeGroup>
+### Install from the terminal
+
+```bash
+npx hyperframes add blue-sweater-intro-video
+```
 
 ## Details
 
@@ -31,18 +32,26 @@ npx hyperframes add blue-sweater-intro-video
 | Dimensions | 1920×1080 |
 | Duration | 12s |
 
-## Files
+**Installed files**
 
 | 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 |
 
-## Usage
+## 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.
 
-After installing, add the block to your host composition:
+**Wiring it by hand.** The installed block can be added to a host composition with:
 
 ```html
 <div data-composition-id="blue-sweater-intro-video" data-composition-src="compositions/blue-sweater-intro-video.html" data-start="0" data-duration="12" data-track-index="1" data-width="1920" data-height="1080"></div>
 ```
+
+## Related topics
+
+- [Browse the complete Catalog](/catalog)
+- [Add assets and Catalog items in Studio](/studio/assets-and-blocks)
+- [Build a richer composition](/go-further)
diff --git a/docs/catalog/blocks/camcorder-hud.mdx b/docs/catalog/blocks/camcorder-hud.mdx
@@ -3,23 +3,24 @@ title: "Camcorder HUD"
 description: "Responsive REC, battery, editable date placeholder, and timeline-driven counter overlay for creator-camera and camcorder treatments"
 ---
 
-# Camcorder HUD
-
-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`
 
 <video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/camcorder-hud.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/camcorder-hud.png" autoPlay muted loop playsInline />
 
-## Install
+## Add it to a project
 
-<CodeGroup>
+### Ask your agent
 
-```bash Terminal
-npx hyperframes add camcorder-hud
+```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.
 ```
 
-</CodeGroup>
+### Install from the terminal
+
+```bash
+npx hyperframes add camcorder-hud
+```
 
 ## Details
 
@@ -29,16 +30,24 @@ npx hyperframes add camcorder-hud
 | Dimensions | 1920×1080 |
 | Duration | 4s |
 
-## Files
+**Installed files**
 
 | File | Target | Type |
 | --- | --- | --- |
 | `camcorder-hud.html` | `compositions/camcorder-hud.html` | hyperframes:composition |
 
-## Usage
+## 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.
 
-After installing, add the block to your host composition:
+**Wiring it by hand.** The installed block can be added to a host composition with:
 
 ```html
 <div data-composition-id="camcorder-hud" data-composition-src="compositions/camcorder-hud.html" data-start="0" data-duration="4" data-track-index="1" data-width="1920" data-height="1080"></div>
 ```
+
+## Related topics
+
+- [Browse the complete Catalog](/catalog)
+- [Add assets and Catalog items in Studio](/studio/assets-and-blocks)
+- [Build a richer composition](/go-further)
diff --git a/docs/catalog/blocks/chromatic-radial-split.mdx b/docs/catalog/blocks/chromatic-radial-split.mdx
@@ -3,23 +3,24 @@ title: "Chromatic Radial Split"
 description: "Shader transition with chromatic aberration radial split"
 ---
 
-# Chromatic Radial Split
-
-Shader transition with chromatic aberration radial split
-
 `transition` `shader`
 
 <video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/chromatic-radial-split.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/chromatic-radial-split.png" autoPlay muted loop playsInline />
 
-## Install
+## Add it to a project
 
-<CodeGroup>
+### Ask your agent
 
-```bash Terminal
-npx hyperframes add chromatic-radial-split
+```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.
 ```
 
-</CodeGroup>
+### Install from the terminal
+
+```bash
+npx hyperframes add chromatic-radial-split
+```
 
 ## Details
 
@@ -29,16 +30,24 @@ npx hyperframes add chromatic-radial-split
 | Dimensions | 1920×1080 |
 | Duration | 4s |
 
-## Files
+**Installed files**
 
 | File | Target | Type |
 | --- | --- | --- |
 | `chromatic-radial-split.html` | `compositions/chromatic-radial-split.html` | hyperframes:composition |
 
-## Usage
+## 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.
 
-After installing, add the block to your host composition:
+**Wiring it by hand.** The installed block can be added to a host composition with:
 
 ```html
 <div data-composition-id="chromatic-radial-split" data-composition-src="compositions/chromatic-radial-split.html" data-start="0" data-duration="4" data-track-index="1" data-width="1920" data-height="1080"></div>
 ```
+
+## Related topics
+
+- [Browse the complete Catalog](/catalog)
+- [Add assets and Catalog items in Studio](/studio/assets-and-blocks)
+- [Build a richer composition](/go-further)