diff --git a/docs/developers/index.mdx b/docs/developers/index.mdx
index fbda8041b8..d91a26b27d 100644
--- a/docs/developers/index.mdx
+++ b/docs/developers/index.mdx
@@ -5,7 +5,7 @@ description: "CLI, SDK, packages, schemas, deployment, integrations, and contrib
This section is for people integrating HyperFrames, automating it, extending the editor, deploying rendering infrastructure, or working directly with composition source.
-If you only want to create or edit a video, begin with [Guides](/guides) or [Studio](/studio).
+If you only want to create or edit a video, begin with [Make your first video](/quickstart) or [Studio](/studio).
## Choose the smallest surface
diff --git a/docs/docs.json b/docs/docs.json
index 46a4f7ceee..02a59f297b 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -54,7 +54,6 @@
{
"group": "Start here",
"pages": [
- "guides/index",
"introduction",
"quickstart",
"workflows",
@@ -512,6 +511,10 @@
}
},
"redirects": [
+ {
+ "source": "/guides",
+ "destination": "/introduction"
+ },
{
"source": "/showcase",
"destination": "/examples"
diff --git a/docs/guides/index.mdx b/docs/guides/index.mdx
deleted file mode 100644
index d4e11a8a7c..0000000000
--- a/docs/guides/index.mdx
+++ /dev/null
@@ -1,39 +0,0 @@
----
-title: "What do you need to do?"
-sidebarTitle: "Overview"
-description: "Choose the shortest HyperFrames documentation path for what you need right now."
----
-
-You do not need to read these docs from beginning to end. Start from your current situation.
-
-
-
- Understand the product, see a finished result, and choose a relevant next step.
-
-
- Go from source material to a reviewable project in Studio and export it.
-
-
- Choose the right path for a product, idea, recording, pull request, motion graphic, song, or presentation.
-
-
- Review the storyboard, make direct edits, adjust timing and animation, or export a version.
-
-
- Start with the visible symptom and return to the task you were trying to finish.
-
-
- Choose the CLI, SDK, Player, package, schema, or deployment surface you actually need.
-
-
-
-## Useful places after the first task
-
-- [Examples](/examples) — watch finished work, inspect production projects, or start from a template.
-- [Catalog](/catalog) — find reusable scenes, captions, transitions, overlays, and effects.
-- [Learn](/concepts) — understand compositions, timing, variables, adapters, and deterministic rendering.
-- [What's new](/product-updates) — follow product changes without reading the technical release archive.
-
-
- If a teammate asks “What is HyperFrames?”, send [What is HyperFrames?](/introduction), not this directory page.
-
diff --git a/docs/introduction.mdx b/docs/introduction.mdx
index ce98248551..4a304432f8 100644
--- a/docs/introduction.mdx
+++ b/docs/introduction.mdx
@@ -1,59 +1,45 @@
---
title: "What is HyperFrames?"
sidebarTitle: "What HyperFrames is"
-description: "See how an AI agent, a real project, and HyperFrames Studio work together to create a finished video."
+description: "Tell an AI agent what you want. It builds a real, editable video project — you refine it in Studio and export the film."
---
-HyperFrames lets an AI agent create a real video project, then gives you a visual Studio to review, edit, and export it.
+**Tell an AI agent what you want. It builds a real, editable video project — you refine it in Studio and export the film.**
-You can begin with an idea, website, script, pull request, recording, or music track. The agent handles the first build. You stay in control of the direction and the visible result.
+Start from an idea, a website, a script, a recording, a pull request, or a song. The agent does the first build. You keep control of the result.
-
+
-
-
- Understand the complete loop without learning the technical architecture.
-
-
- Go from your own source material to a reviewable result in Studio.
-
-
-
-## From request to finished result
+## From request to video
```mermaid
flowchart LR
- A["Your idea or source"] --> B["AI agent"]
+ A["Your request"] --> B["AI agent"]
B --> C["HyperFrames project"]
- C --> D["Studio review and edits"]
- D --> E["Finished video or presentation"]
+ C --> D["Video"]
```
-
- Tell the agent what you want the viewer to understand, feel, or do. Attach a website, text, footage, code change, music, or other source when you have one.
+
+ Tell the agent what you want the viewer to understand, feel, or do — and attach a source if you have one.
- The agent confirms the important creative choices before spending time on the build.
-
-
- The first version opens in HyperFrames Studio. It is not a flattened mystery file: the scenes, timing, media, text, and animation remain editable.
+ The agent confirms the important creative choices before it spends time building.
-
- Make direct changes in Studio or ask the agent for a broader revision.
+
+ The first version opens in HyperFrames Studio — not a flattened export, but a real project whose scenes, timing, text, media, and animation stay editable. Change what you can point at, or ask the agent for a broader revision.
-
- Render a normal video, a transparent overlay, a high-resolution file, or keep the work as a navigable presentation.
+
+ Render a standard video, a transparent overlay, a high-resolution file — or keep it as a navigable presentation.
@@ -82,32 +68,31 @@ flowchart LR
[Watch more finished work →](/examples)
-## What the person controls
+## Who does what
-HyperFrames is built so an agent can do the source-heavy work without hiding the result from you.
+The agent does the source-heavy work. Studio is where you stay in control — nothing is hidden behind a locked file.
-| Use Studio when… | Ask the agent when… |
+| Reach for Studio when… | Ask the agent when… |
| --- | --- |
| You can point at the exact text or visual. | The story or message needs to change. |
| A clip needs to move, trim, or split. | Several scenes need coordinated changes. |
-| Color, size, position, or timing needs a direct adjustment. | New media, research, narration, or source work is required. |
+| Color, size, position, or timing needs a direct nudge. | New media, research, narration, or source work is required. |
| You want to compare and export versions. | You know the outcome but not the implementation. |
-You do not need to understand HTML, packages, schemas, or the rendering engine to create and review a video. Those details remain available in [Developers](/developers) when somebody is integrating or extending the framework.
+You never have to touch HTML, packages, or the rendering engine to make and review a video. Those live in [Developers](/developers) — for the people integrating or extending HyperFrames.
-## Choose your next step
+## Start here
-
-
- Explore the Playground without beginning in a local project.
-
+The shortest path is to **make one**.
+
+
- Follow the shortest complete path from source material to export.
+ Go from your own source material to a finished export. ~10 minutes.
-
- Find the correct path for a product, idea, recording, PR, motion graphic, song, or presentation.
+
+ Explore and remix in the Playground — nothing to install.
-
- Learn how to review, edit, and export work that an agent or teammate already created.
+
+ Learn to review, edit, and export work an agent already built.