Skip to content

Set up

Video components are HyperFrames scenes. Add them to a project, load the runtime once, and place them in a film, by hand or with an agent that follows the video skills.

  1. 1

    Start a HyperFrames project

    Mizzle's video components are HyperFrames scenes: HTML that renders to video, frame by frame.

    npx hyperframes init my-film
  2. 2

    Point shadcn at Mizzle

    In the project, add a components.json with the registry and your license key from .env.local. The CLI also needs a jsconfig.json to find the folder: { "compilerOptions": { "baseUrl": "." } }.

    components.json

    1{
    2 "$schema": "https://ui.shadcn.com/schema.json",
    3 "style": "new-york",
    4 "rsc": false,
    5 "tsx": false,
    6 "tailwind": { "css": "", "baseColor": "neutral", "cssVariables": true },
    7 "aliases": { "components": "components", "utils": "lib/utils" },
    8 "registries": {
    9 "@mizzle": {
    10 "url": "https://mizzle.saddy.me/r/{name}.json",
    11 "headers": { "Authorization": "Bearer ${MIZZLE_LICENSE}" }
    12 }
    13 }
    14}
  3. 3

    Add a component

    Each one lands in compositions/, and the runtime they paint with in assets/.

    npx shadcn@latest add @mizzle/video-photo-title
  4. 4

    Load the runtime

    Once, in index.html, after GSAP. The film's root takes mv-ground: one background under every clip, in the light or dark theme.

    index.html

    1<link rel="stylesheet" href="assets/mizzle-video.css" />
    2<script src="assets/mizzle-video.js"></script>
    3
    4<div id="root" class="mv-ground" data-theme="light" data-composition-id="main"
    5 data-start="0" data-duration="10" data-width="1920" data-height="1080">
    6 <!-- the clips -->
    7</div>
  5. 5

    Give your agent the video skills

    The skills are how an agent makes a film with the components: the film format, story and pacing, a checklist against generated-looking video, and a builder that turns a film file into its page. Ask for a film and it follows them.

    npx shadcn@latest add @mizzle/video-skills
  6. 6

    Review on a page, not in chat

    Your agent starts a local review page after each render. Watch the film, pause where something is off, press N and write the note on that moment, then approve or send back. Tell the agent to read your notes and it works from exactly what you wrote.

    node mizzle/review.mjs