Template System

Templates expand into normal clips at runtime. They should not be treated as parent containers that automatically pass styling or animation to their generated children.

1. Registered templates

Currently supported:

product-intro
slideshow
subtitle-video
talking-head
comparison
countdown
text-reveal
news
quote
list

2. Shared limits

These fields on the template clip itself are not documented as inherited by generated child clips:

transform
style
animations
keyframes
transition

Template-specific control should be passed through data.

3. `product-intro`

Effective fields:

name
tagline
features
price
image
cta

Behavior:

Optional product image on the left
Product title and supporting text on the right
Optional feature list
Optional price
Optional CTA text

Example:

{
  "type": "template",
  "template": "product-intro",
  "start": 0,
  "duration": 8,
  "data": {
    "name": "Smart Watch Pro",
    "tagline": "Built for modern teams",
    "features": ["AMOLED display", "7-day battery", "Health tracking"],
    "price": "$299",
    "image": "https://example.com/watch.png",
    "cta": "Order Now"
  }
}

4. `slideshow`

Effective fields:

images
durationPerSlide
showCaptions

Behavior:

Each image expands into an image clip
Slides use the current built-in transition behavior
Caption text is generated when a slide includes caption and showCaptions !== false

Example:

{
  "type": "template",
  "template": "slideshow",
  "start": 0,
  "duration": 9,
  "data": {
    "images": [
      { "image": "https://example.com/slide-1.jpg", "caption": "Welcome" },
      { "image": "https://example.com/slide-2.jpg", "caption": "New Features" },
      { "image": "https://example.com/slide-3.jpg", "caption": "Get Started" }
    ],
    "durationPerSlide": 3,
    "showCaptions": true
  }
}

5. `subtitle-video`

Effective fields:

src
words
config
source
volume
muted
playbackRate

Behavior:

Generates a full-screen video
Generates a subtitle

Example:

{
  "type": "template",
  "template": "subtitle-video",
  "start": 0,
  "duration": 8,
  "data": {
    "src": { "$ref": "host-video" },
    "words": { "$ref": "subtitle-main" },
    "muted": false,
    "volume": 1,
    "config": {
      "position": "bottom",
      "fontSize": 58,
      "highlightColor": "#22d3ee"
    }
  }
}

6. `talking-head`

Effective fields:

src
words
config
source
volume
muted
playbackRate
speaker
role
title
showLowerThird

Behavior:

Generates a full-screen host video
Optional top title
Optional lower-third block
Optional subtitle track

Example:

{
  "type": "template",
  "template": "talking-head",
  "start": 0,
  "duration": 8,
  "data": {
    "src": { "$ref": "host-video" },
    "words": { "$ref": "subtitle-main" },
    "title": "Weekly Update",
    "speaker": "Alex Chen",
    "role": "Founder",
    "showLowerThird": true,
    "config": {
      "position": "bottom",
      "fontSize": 60,
      "highlightColor": "#22d3ee"
    }
  }
}

7. `comparison`

Effective fields:

left.title
left.items
left.image
right.title
right.items
right.image
vsText

Behavior:

Generates left and right comparison blocks
Optional images and lists for both sides
Generates center divider and VS text

Example:

{
  "type": "template",
  "template": "comparison",
  "start": 0,
  "duration": 7,
  "data": {
    "left": {
      "title": "Before",
      "items": ["Manual workflow", "Slow review", "Higher cost"],
      "image": "https://example.com/before.png"
    },
    "right": {
      "title": "After",
      "items": ["Automated workflow", "Fast review", "Lower cost"],
      "image": "https://example.com/after.png"
    },
    "vsText": "VS"
  }
}

8. `countdown`

Effective fields:

from
to
showText
onComplete

Behavior:

Renders a countdown sequence
Can show helper text near completion
Can show a completion message

Example:

{
  "type": "template",
  "template": "countdown",
  "start": 0,
  "duration": 6,
  "data": {
    "from": 5,
    "to": 0,
    "showText": true,
    "onComplete": "Launch"
  }
}

9. `text-reveal`

Effective fields:

text
style
fontSize
color
textAlign
position

Documented style values:

fade
slide
zoom

Behavior:

Generates one or more text clips for staged reveal
Uses the selected reveal style where currently implemented

Example:

{
  "type": "template",
  "template": "text-reveal",
  "start": 0,
  "duration": 5,
  "data": {
    "text": "Ship faster with AI video",
    "style": "slide",
    "fontSize": 72,
    "color": "#ffffff",
    "textAlign": "center",
    "position": "center"
  }
}

10. `news`

Effective fields:

headline
content
reporter
location
showLowerThird

Behavior:

Main headline
Optional content block
Optional lower-third information block

Example:

{
  "type": "template",
  "template": "news",
  "start": 0,
  "duration": 8,
  "data": {
    "headline": "Quarterly results exceed expectations",
    "content": "Revenue grew 38% year over year, driven by strong subscription growth.",
    "reporter": "Maya Lin",
    "location": "San Francisco",
    "showLowerThird": true
  }
}

11. `quote`

Effective fields:

quote
author
source

Behavior:

Renders quote text
Optional author and source line

Example:

{
  "type": "template",
  "template": "quote",
  "start": 0,
  "duration": 6,
  "data": {
    "quote": "Simplicity scales better than complexity.",
    "author": "Alex Chen",
    "source": "Team Memo"
  }
}

12. `list`

Effective fields:

title
items
style
itemDuration
animation

Behavior:

Generates a title when provided
Generates list items in sequence
Supports marker style and item animation
itemDuration: "auto" distributes the total time automatically

Example:

{
  "type": "template",
  "template": "list",
  "start": 0,
  "duration": 8,
  "data": {
    "title": "Release Checklist",
    "items": ["Finalize copy", "Export assets", "Publish update"],
    "style": "checkmark",
    "itemDuration": "auto",
    "animation": "fadeIn"
  }
}

On this page