Files
hyperframes/docs/developers/index.mdx
T
ukimsanov bb2df65dd1 docs: rebuild the introduction as a real front door
Make /introduction the single "What is HyperFrames?" page a stranger can be
sent, and retire the switchboard that sat in front of it.

- introduction: lead with one sentence + a sound-on result (drop `muted`),
  simplify the loop diagram to request -> agent -> project -> video, cut the
  fake "See how it works" scroll button, and replace the equal-weight card
  walls with one clear "Start here" action.
- guides/index: remove the six-card "What do you need to do?" menu-of-menus.
  The nav already routes people and /introduction is the real entry point.
  Redirect /guides -> /introduction.
- developers: point the "create a video" link at /quickstart.

mint validate and mint broken-links both pass.
2026-07-29 12:19:10 -07:00

62 lines
2.6 KiB
Plaintext

---
title: "Developers"
description: "CLI, SDK, packages, schemas, deployment, integrations, and contribution guides."
---
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 [Make your first video](/quickstart) or [Studio](/studio).
## Choose the smallest surface
```mermaid
flowchart TD
A["What does your system need to do?"] --> B["Run commands or CI jobs"]
A --> C["Inspect or edit compositions in an app"]
A --> D["Embed playback"]
A --> E["Operate custom render infrastructure"]
A --> F["Generate or validate raw composition source"]
B --> G["CLI"]
C --> H["SDK"]
D --> I["Player"]
E --> J["Focused packages and deployment guides"]
F --> K["HTML schema and animation reference"]
```
<CardGroup cols={2}>
<Card title="CLI" icon="terminal" href="/developers/cli">
Create, check, render, publish, and automate projects from a terminal or CI job.
</Card>
<Card title="SDK quickstart" icon="code" href="/sdk/quickstart">
Open a composition, query or edit it, persist changes, and build custom editing surfaces.
</Card>
<Card title="Player" icon="circle-play" href="/packages/player">
Embed a seekable HyperFrames composition and control playback from an application.
</Card>
<Card title="Packages" icon="boxes-stacked" href="/packages/core">
Add focused parsing, playback, rendering, Studio, or infrastructure capabilities.
</Card>
<Card title="Deployment" icon="cloud" href="/deploy/cloud">
Render with managed cloud infrastructure, AWS Lambda, or Google Cloud Run.
</Card>
<Card title="HTML schema" icon="brackets-curly" href="/reference/html-schema">
Reference composition elements, timing attributes, tracks, variables, and the media contract.
</Card>
</CardGroup>
## A good first technical result
Choose one result rather than installing the whole repository:
- render one known project from a script or CI job;
- open one composition with the SDK and change one value;
- embed one project with the Player and seek to a timestamp;
- deploy one minimal render path;
- validate one generated composition against the schema.
Continue to package or reference pages only when that working path requires more control. Most integrations should not depend on every HyperFrames package.
## Working on HyperFrames itself?
Use [Contributing](/contributing) for repository setup, tests, Catalog contributions, and releases. Product integrations should begin with one of the surfaces above instead.