Narrated Slide Video

What to say

How it works

1. Write the deck JSON
2. Render with the deck video script

Example input (examples/slide_deck.json)

{
  "slug": "slide-deck-example",
  "title": "Slide deck example",
  "theme": "dark",
  "accent": "#FF7A45",
  "watermark": "@yourhandle",
  "slides": [
    {
      "kind": "hook",
      "heading": "Your first frame is a reason to stay.",
      "sub": "Not a title card.",
      "hold": 2
    },
    {
      "kind": "bullets",
      "heading": "Three rules",
      "bullets": [
        "One idea per slide",
        "Payoff after second three",
        "Loop the last frame into the first"
      ],
      "hold": 4
    },
    {
      "kind": "code",
      "heading": "Show the command",
      "lang": "bash",
      "code": "uv run scripts/slides/render_slide_deck.py deck.json",
      "hold": 3
    },
    {
      "kind": "compare",
      "heading": "Before / after",
      "left": { "label": "Before", "body": "Nine cards of 12px text" },
      "right": { "label": "After", "body": "One line, 108px, unmissable" },
      "hold": 4
    },
    {
      "kind": "diagram",
      "heading": "The flow",
      "nodes": ["Hook", "Proof", "Payoff", "Ask"],
      "hold": 3
    },
    {
      "kind": "cta",
      "heading": "Comment DECK and I'll send the template.",
...