Skip to content

Commit f742084

Browse files
committed
docs: put the ten workflows in one place, and connect the two tracks
There are ten creation workflows. The Workflows nav group held eight of them plus `guides/export-and-share`, which is not a workflow at all — there is no such skill, it is a finishing task. The tenth, the Remotion port, sat under Developers > Composition, design & animation, a different tab entirely. So: export-and-share moved to Build the project where the other task pages live, the Remotion page moved into Workflows, and the chooser gained a tenth route. The chooser rendered `<video>` unconditionally, which would have drawn a black rectangle for a route with no clip — it now renders a neutral tile instead, and custom.css styles it to the same box. **The Prompt Guide and the workflow guides did not know about each other.** Level 1 is organised one page per workflow, and five of its six pages linked to no guide at all. A reader learning to prompt for motion graphics never discovered /guides/motion-graphics, and the traffic went nowhere in both directions. Each Level 1 page now names its workflow and says what that page adds. Four links pointed at redirects rather than the real page — /guides/claude-design, /guides/common-mistakes, /guides/website-to-video, /guides/media-overlays. Seven files now link to the destination directly. Checked after: 0 broken links, 0 links via redirect.
1 parent c669616 commit f742084

17 files changed

Lines changed: 329 additions & 321 deletions

‎docs/concepts/compositions.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -166,7 +166,7 @@ animation.
166166
Never use a script to play, pause, or seek a media element, and never use one
167167
to show or hide a clip based on time. The framework already does that from the
168168
data attributes, and a script doing it too will fight the framework. See
169-
[Common Mistakes](/guides/common-mistakes) for what that looks like.
169+
[Common Mistakes](/guides/troubleshooting) for what that looks like.
170170
</Warning>
171171

172172
## Reuse one composition with different content

‎docs/concepts/determinism.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -94,4 +94,4 @@ that stutters in preview still renders perfectly — see
9494
- [Render to MP4](/guides/rendering)
9595
- [Compositions](/concepts/compositions)
9696
- [@hyperframes/producer](/packages/producer)
97-
- [Common mistakes that break determinism](/guides/common-mistakes)
97+
- [Common mistakes that break determinism](/guides/troubleshooting)

‎docs/contributing/canary-rollouts.mdx‎

Lines changed: 45 additions & 267 deletions
Large diffs are not rendered by default.

‎docs/custom.css‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -182,6 +182,16 @@ h3 {
182182
object-fit: cover;
183183
pointer-events: none;
184184
}
185+
/* A route with no preview clip: same box, no black rectangle. */
186+
.hf-workflow-route-noclip {
187+
display: block;
188+
width: 100%;
189+
aspect-ratio: 16 / 9;
190+
margin: 0;
191+
border-radius: 0.5rem;
192+
background: color-mix(in srgb, currentColor 8%, transparent);
193+
}
194+
185195

186196
.hf-workflow-route-title {
187197
display: block;

‎docs/docs.json‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -173,7 +173,7 @@
173173
"guides/music-to-video",
174174
"guides/slideshow",
175175
"guides/general-video",
176-
"guides/export-and-share"
176+
"guides/hyperframes-vs-remotion"
177177
]
178178
},
179179
{
@@ -186,7 +186,8 @@
186186
"guides/voice-and-audio",
187187
"guides/remove-background",
188188
"guides/color-grading",
189-
"guides/media-effects"
189+
"guides/media-effects",
190+
"guides/export-and-share"
190191
]
191192
},
192193
{
@@ -530,7 +531,6 @@
530531
"concepts/frame-adapters",
531532
"concepts/determinism",
532533
"guides/html-in-canvas",
533-
"guides/hyperframes-vs-remotion",
534534
"guides/figma"
535535
]
536536
},

‎docs/guides/design-tools.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,7 @@ These settle layout, palette, type, and scene direction first.
7171
3. Save it to disk, then open that folder with a coding agent.
7272
4. Let the agent check timing, motion, media, captions, and rendering.
7373

74-
[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)
74+
[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)
7575

7676
## Is the handoff any good?
7777

‎docs/prompting/captions-and-talking-heads.mdx‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -99,4 +99,6 @@ What you can already steer from the prompt, before you've learned any technique.
9999
For the beat-timestamped skeleton these prompts share, see [Prompt anatomy](/prompting/anatomy); for adjectives that map to motion and emphasis settings, [Vocabulary](/prompting/vocabulary). To build a video from scratch instead of dressing existing footage, start at the router in `/hyperframes`.
100100
</Tip>
101101

102+
The workflow this level rides is documented at [Captions and talking head](/guides/captions-and-recuts) — what it takes as input, what it asks you before it builds, and what it returns.
103+
102104
*Next: [Music videos and slideshows](/prompting/music-and-slideshows) — swap footage for a soundtrack, or slides, and let the beat or the deck set the pace.*

‎docs/prompting/code-and-prs.mdx‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -93,4 +93,6 @@ What you can already steer from the prompt, before you've learned any technique.
9393
- ❌ `a 40-second narrated walkthrough`
9494
- ✅ `a ~40-second narrated walkthrough`
9595

96+
The workflow this level rides is documented at [PR to video](/guides/pr-to-video) — what it takes as input, what it asks you before it builds, and what it returns.
97+
9698
*Next: [Captions and talking-head footage](/prompting/captions-and-talking-heads) — same one-prompt move, now dressing footage you already shot.*

‎docs/prompting/color-grading.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -193,7 +193,7 @@ If you composite a subject into the shot, do it **before** grading. A CRT warps
193193
/>
194194
*The footage degrades; the HUD does not. It is an overlay, composed above the media canvas.*
195195

196-
The HUD in that shot is not part of the grade. It is a [`camcorder-hud`](/guides/media-overlays) registry block — real HTML, CSS, and a paused GSAP timeline composed *above* the media canvas. Grading never touches it, which is exactly what you want: burn a timestamp into the source pixels and it degrades with them; put it in an overlay and it stays crisp, editable, and timeline-driven while the footage falls apart underneath.
196+
The HUD in that shot is not part of the grade. It is a [`camcorder-hud`](/catalog) registry block — real HTML, CSS, and a paused GSAP timeline composed *above* the media canvas. Grading never touches it, which is exactly what you want: burn a timestamp into the source pixels and it degrades with them; put it in an overlay and it stays crisp, editable, and timeline-driven while the footage falls apart underneath.
197197

198198
## Animating a grade
199199

‎docs/prompting/design-systems.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -115,7 +115,7 @@ Restyling scene by scene afterward pulls threads out of a design that was balanc
115115
<Card title="The specification dial" icon="gauge" href="/prompting/specification-dial">
116116
How pinning exact hexes and type direction removes drift.
117117
</Card>
118-
<Card title="Claude Design" icon="message" href="/guides/claude-design">
118+
<Card title="Claude Design" icon="message" href="/guides/design-tools">
119119
Attach a brand guide or screenshot to seed a first draft from your look.
120120
</Card>
121121
</CardGroup>

0 commit comments

Comments
 (0)