docs: make the pages show the thing they describe

docs/catalog/blocks/app-showcase.mdx

@@ -3,48 +3,38 @@ title: "App Showcase"
 description: "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 />
 
-## Add it to a project
-
-### 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
+## Install
 
-```bash
+```bash Terminal
 npx hyperframes add app-showcase
 ```
 
-## Details
-
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920×1080 |
-| Duration | 5.5s |
+That writes one file: `compositions/app-showcase.html`.
 
-**Installed files**
+## Add it to your video
 
-| File | Target | Type |
-| --- | --- | --- |
-| `app-showcase.html` | `compositions/app-showcase.html` | hyperframes:composition |
+It runs for 5.5 seconds at 1920×1080. Paste this into your composition:
 
-## Use it
+```html index.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>
+```
 
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
+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.
 
-**Wiring it by hand.** The installed block can be added to a host composition with:
+{/* hf:generated-footer */}
 
-```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>
-```
+Tagged `showcase` `app` `3d`.
 
 ## Related topics
 

docs/catalog/blocks/apple-money-count.mdx

@@ -3,58 +3,49 @@ 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`
-
-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.
-```
-
 <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 />
 
-## Add it to a project
-
-### Ask your agent
+## Install
 
-```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.
+```bash Terminal
+npx hyperframes add apple-money-count
 ```
 
-### Install from the terminal
+That writes `compositions/apple-money-count.html`, plus 1 supporting file under `assets/`.
 
-```bash
-npx hyperframes add apple-money-count
-```
+## Add it to your video
 
-## Details
+It runs for 5 seconds at 1920×1080. Paste this into your composition:
 
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920×1080 |
-| Duration | 5s |
+```html index.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>
+```
 
-**Installed files**
+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.
 
-| File | Target | Type |
-| --- | --- | --- |
-| `apple-money-count.html` | `compositions/apple-money-count.html` | hyperframes:composition |
-| `assets/sfx-production.wav` | `assets/sfx-production.wav` | hyperframes:asset |
+{/* hf:generated-footer */}
 
-## Use it
+Tagged `showcase` `finance` `kinetic` `youtube` `sfx`.
 
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
+Created by [Stronkter](https://x.com/Stronkter).
 
-**Wiring it by hand.** The installed block can be added to a host composition with:
+<Accordion title="The prompt this was built from">
 
-```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>
+```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.
 ```
 
+</Accordion>
+
 ## Related topics
 
 - [Browse the complete Catalog](/catalog)

docs/catalog/blocks/beat-freeze-cut.mdx

@@ -3,48 +3,45 @@ 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`
-
 <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 />
 
-## Add it to a project
-
-### Ask your agent
+## Install
 
-```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.
+```bash Terminal
+npx hyperframes add beat-freeze-cut
 ```
 
-### Install from the terminal
+That writes one file: `compositions/beat-freeze-cut.html`.
 
-```bash
-npx hyperframes add beat-freeze-cut
-```
+## Add it to your video
 
-## Details
+It runs for 6 seconds at 1920×1080. Paste this into your composition:
 
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920×1080 |
-| Duration | 6s |
+```html index.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>
+```
 
-**Installed files**
+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.
 
-| File | Target | Type |
-| --- | --- | --- |
-| `beat-freeze-cut.html` | `compositions/beat-freeze-cut.html` | hyperframes:composition |
+## Change the colors
 
-## Use it
+Set these CSS variables on the block:
 
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
+- `--bg-color` — Background. Defaults to `#0B0D10`.
+- `--accent-color` — Accent. Defaults to `#00E5C7`.
 
-**Wiring it by hand.** The installed block can be added to a host composition with:
+{/* hf:generated-footer */}
 
-```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>
-```
+Tagged `transition` `music` `beat-driven` `freeze-frame`.
 
 ## Related topics
 

docs/catalog/blocks/blue-sweater-intro-video.mdx

@@ -3,52 +3,40 @@ 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_).
-
 <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 />
 
-## Add it to a project
-
-### 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
+## Install
 
-```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 |
+```html index.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>
+```
 
-## Use it
+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.
 
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
+{/* hf:generated-footer */}
 
-**Wiring it by hand.** The installed block can be added to a host composition with:
+Tagged `showcase` `ai` `creator` `sfx`.
 
-```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>
-```
+Created by [Joe Sai](https://x.com/_blue_sweater_).
 
 ## Related topics
 

docs/catalog/blocks/camcorder-hud.mdx

@@ -3,48 +3,38 @@ 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`
-
 <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 />
 
-## Add it to a project
-
-### 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
+## Install
 
-```bash
+```bash Terminal
 npx hyperframes add camcorder-hud
 ```
 
-## Details
-
-| Property | Value |
-| --- | --- |
-| Type | Block |
-| Dimensions | 1920×1080 |
-| Duration | 4s |
+That writes one file: `compositions/camcorder-hud.html`.
 
-**Installed files**
+## Add it to your video
 
-| File | Target | Type |
-| --- | --- | --- |
-| `camcorder-hud.html` | `compositions/camcorder-hud.html` | hyperframes:composition |
+It runs for 4 seconds at 1920×1080. Paste this into your composition:
 
-## Use it
+```html index.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>
+```
 
-Ask your agent to replace the example content, match the project style, and place the block at the right moment in the video.
+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.
 
-**Wiring it by hand.** The installed block can be added to a host composition with:
+{/* hf:generated-footer */}
 
-```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>
-```
+Tagged `camcorder` `camera` `recording` `hud` `overlay` `creator` `media-treatment-overlay`.
 
 ## Related topics