Raw schema
{
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"brief": {
"type": "string",
"minLength": 1,
"maxLength": 1200
},
"aspect": {
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1",
"4:5"
]
},
"length_s": {
"type": "number",
"minimum": 3,
"maximum": 900
},
"fps": {
"type": "integer",
"minimum": 12,
"maximum": 120
},
"bpm": {
"type": "number",
"minimum": 40,
"maximum": 220
},
"brand": {
"description": "Brandprint import used for the look, if any",
"type": "string",
"maxLength": 80
},
"directions": {
"minItems": 1,
"maxItems": 4,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"logline": {
"type": "string",
"minLength": 1,
"maxLength": 280,
"description": "the idea in one line"
},
"references": {
"maxItems": 6,
"type": "array",
"items": {
"type": "object",
"properties": {
"ref": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "REF id"
},
"contributes": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"description": "the one job it does, e.g. 'structure and timing', 'the hook', 'type treatment'"
}
},
"required": [
"ref",
"contributes"
]
}
},
"palette": {
"maxItems": 8,
"type": "array",
"items": {
"type": "string",
"pattern": "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"
}
},
"type": {
"type": "object",
"properties": {
"display": {
"type": "string",
"maxLength": 60
},
"body": {
"type": "string",
"maxLength": 60
},
"mono": {
"type": "string",
"maxLength": 60
},
"note": {
"type": "string",
"maxLength": 200
}
},
"required": [
"display",
"body"
]
},
"sound": {
"type": "string",
"maxLength": 400,
"description": "music and sound design in a line or two"
},
"motion": {
"description": "how frames hand off to each other overall",
"type": "string",
"maxLength": 400
},
"style_frames": {
"maxItems": 3,
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"note": {
"type": "string",
"maxLength": 300
},
"frame": {
"type": "object",
"properties": {
"background": {
"type": "string",
"pattern": "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"
},
"gradient": {
"description": "top to bottom; replaces background",
"type": "array",
"prefixItems": [
{
"type": "string",
"pattern": "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"
},
{
"type": "string",
"pattern": "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"
}
],
"items": false,
"minItems": 2,
"maxItems": 2
},
"layers": {
"maxItems": 40,
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "text"
},
"text": {
"type": "string",
"minLength": 1,
"maxLength": 400
},
"x": {
"type": "number",
"minimum": -50,
"maximum": 150,
"description": "left edge, % of frame width"
},
"y": {
"type": "number",
"minimum": -50,
"maximum": 150,
"description": "top edge, % of frame height"
},
"w": {
"description": "box width, % of frame width (text wraps inside it)",
"type": "number",
"minimum": -50,
"maximum": 150
},
"size": {
"type": "number",
"minimum": 0.5,
"maximum": 80,
"description": "font size as % of frame height"
},
"weight": {
"type": "integer",
"minimum": 100,
"maximum": 900
},
"font": {
"description": "display = the direction's headline face, body = UI/sans, mono = data, serif = editorial",
"type": "string",
"enum": [
"display",
"body",
"mono",
"serif"
]
},
"color": {
"type": "string",
"pattern": "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"
},
"align": {
"type": "string",
"enum": [
"left",
"center",
"right"
]
},
"italic": {
"type": "boolean"
},
"tracking": {
"description": "letter spacing in em",
"type": "number",
"minimum": -0.2,
"maximum": 0.6
},
"opacity": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"real": {
"description": "true only when this is a real capture of the user's product or a real result; anything else is illustrative and is labelled so",
"type": "boolean"
}
},
"required": [
"type",
"text",
"x",
"y",
"size"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "image"
},
"src": {
"type": "string",
"minLength": 1,
"maxLength": 600,
"description": "\"REF-1234\" for that archive film's still, or an https URL of the user's own capture"
},
"x": {
"type": "number",
"minimum": -50,
"maximum": 150
},
"y": {
"type": "number",
"minimum": -50,
"maximum": 150
},
"w": {
"type": "number",
"minimum": -50,
"maximum": 150
},
"h": {
"type": "number",
"minimum": -50,
"maximum": 150
},
"fit": {
"type": "string",
"enum": [
"cover",
"contain"
]
},
"radius": {
"description": "corner radius, % of frame height",
"type": "number",
"minimum": 0,
"maximum": 50
},
"opacity": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"grayscale": {
"type": "boolean"
},
"real": {
"description": "true only when this is a real capture of the user's product or a real result; anything else is illustrative and is labelled so",
"type": "boolean"
}
},
"required": [
"type",
"src",
"x",
"y",
"w",
"h"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "shape"
},
"shape": {
"type": "string",
"enum": [
"rect",
"circle",
"line"
]
},
"x": {
"type": "number",
"minimum": -50,
"maximum": 150
},
"y": {
"type": "number",
"minimum": -50,
"maximum": 150
},
"w": {
"type": "number",
"minimum": -50,
"maximum": 150
},
"h": {
"type": "number",
"minimum": -50,
"maximum": 150
},
"fill": {
"type": "string",
"pattern": "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"
},
"stroke": {
"type": "string",
"pattern": "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"
},
"stroke_width": {
"description": "% of frame height",
"type": "number",
"minimum": 0,
"maximum": 5
},
"radius": {
"type": "number",
"minimum": 0,
"maximum": 50
},
"opacity": {
"type": "number",
"minimum": 0,
"maximum": 1
}
},
"required": [
"type",
"shape",
"x",
"y",
"w",
"h"
]
}
]
}
}
},
"required": [
"layers"
]
}
},
"required": [
"title",
"frame"
]
},
"description": "2β3 key frames at full look"
},
"panels": {
"minItems": 3,
"maxItems": 30,
"type": "array",
"items": {
"type": "object",
"properties": {
"shot": {
"description": "shot number; numbered 1, 2, 3β¦ when left out",
"type": "string",
"maxLength": 12
},
"start": {
"type": "number",
"minimum": 0,
"maximum": 900,
"description": "in, seconds"
},
"end": {
"type": "number",
"minimum": 0,
"maximum": 900,
"description": "out, seconds"
},
"shot_size": {
"type": "string",
"enum": [
"extreme wide",
"wide",
"medium",
"close",
"extreme close",
"macro",
"insert",
"ui",
"full-frame type"
]
},
"camera": {
"description": "the camera move, drawn as arrows on the panel",
"type": "string",
"enum": [
"static",
"push in",
"pull out",
"pan left",
"pan right",
"tilt up",
"tilt down",
"truck left",
"truck right",
"orbit",
"zoom in",
"zoom out",
"whip",
"handheld"
]
},
"action": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"description": "what happens and what moves, in one or two sentences"
},
"vo": {
"description": "the spoken line over this panel",
"type": "string",
"maxLength": 400
},
"on_screen": {
"description": "text that appears on screen",
"type": "string",
"maxLength": 200
},
"sound": {
"description": "music cue or SFX",
"type": "string",
"maxLength": 200
},
"transition": {
"description": "how this panel becomes the next one",
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"cut",
"match cut",
"dissolve",
"morph",
"wipe",
"push",
"whip",
"fade to black",
"hold"
]
},
"frames": {
"type": "integer",
"minimum": 0,
"maximum": 240
},
"note": {
"description": "how this frame becomes the next, e.g. 'the caret stretches into the search bar'",
"type": "string",
"maxLength": 200
}
},
"required": [
"kind"
]
},
"look_ref": {
"description": "REF id whose look this panel borrows",
"type": "string",
"maxLength": 20
},
"frame": {
"type": "object",
"properties": {
"background": {
"type": "string",
"pattern": "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"
},
"gradient": {
"description": "top to bottom; replaces background",
"type": "array",
"prefixItems": [
{
"type": "string",
"pattern": "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"
},
{
"type": "string",
"pattern": "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"
}
],
"items": false,
"minItems": 2,
"maxItems": 2
},
"layers": {
"maxItems": 40,
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "text"
},
"text": {
"type": "string",
"minLength": 1,
"maxLength": 400
},
"x": {
"type": "number",
"minimum": -50,
"maximum": 150,
"description": "left edge, % of frame width"
},
"y": {
"type": "number",
"minimum": -50,
"maximum": 150,
"description": "top edge, % of frame height"
},
"w": {
"description": "box width, % of frame width (text wraps inside it)",
"type": "number",
"minimum": -50,
"maximum": 150
},
"size": {
"type": "number",
"minimum": 0.5,
"maximum": 80,
"description": "font size as % of frame height"
},
"weight": {
"type": "integer",
"minimum": 100,
"maximum": 900
},
"font": {
"description": "display = the direction's headline face, body = UI/sans, mono = data, serif = editorial",
"type": "string",
"enum": [
"display",
"body",
"mono",
"serif"
]
},
"color": {
"type": "string",
"pattern": "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"
},
"align": {
"type": "string",
"enum": [
"left",
"center",
"right"
]
},
"italic": {
"type": "boolean"
},
"tracking": {
"description": "letter spacing in em",
"type": "number",
"minimum": -0.2,
"maximum": 0.6
},
"opacity": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"real": {
"description": "true only when this is a real capture of the user's product or a real result; anything else is illustrative and is labelled so",
"type": "boolean"
}
},
"required": [
"type",
"text",
"x",
"y",
"size"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "image"
},
"src": {
"type": "string",
"minLength": 1,
"maxLength": 600,
"description": "\"REF-1234\" for that archive film's still, or an https URL of the user's own capture"
},
"x": {
"type": "number",
"minimum": -50,
"maximum": 150
},
"y": {
"type": "number",
"minimum": -50,
"maximum": 150
},
"w": {
"type": "number",
"minimum": -50,
"maximum": 150
},
"h": {
"type": "number",
"minimum": -50,
"maximum": 150
},
"fit": {
"type": "string",
"enum": [
"cover",
"contain"
]
},
"radius": {
"description": "corner radius, % of frame height",
"type": "number",
"minimum": 0,
"maximum": 50
},
"opacity": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"grayscale": {
"type": "boolean"
},
"real": {
"description": "true only when this is a real capture of the user's product or a real result; anything else is illustrative and is labelled so",
"type": "boolean"
}
},
"required": [
"type",
"src",
"x",
"y",
"w",
"h"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "shape"
},
"shape": {
"type": "string",
"enum": [
"rect",
"circle",
"line"
]
},
"x": {
"type": "number",
"minimum": -50,
"maximum": 150
},
"y": {
"type": "number",
"minimum": -50,
"maximum": 150
},
"w": {
"type": "number",
"minimum": -50,
"maximum": 150
},
"h": {
"type": "number",
"minimum": -50,
"maximum": 150
},
"fill": {
"type": "string",
"pattern": "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"
},
"stroke": {
"type": "string",
"pattern": "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"
},
"stroke_width": {
"description": "% of frame height",
"type": "number",
"minimum": 0,
"maximum": 5
},
"radius": {
"type": "number",
"minimum": 0,
"maximum": 50
},
"opacity": {
"type": "number",
"minimum": 0,
"maximum": 1
}
},
"required": [
"type",
"shape",
"x",
"y",
"w",
"h"
]
}
]
}
}
},
"required": [
"layers"
]
}
},
"required": [
"start",
"end",
"action",
"frame"
]
}
}
},
"required": [
"name",
"logline",
"references",
"palette",
"type",
"sound",
"style_frames",
"panels"
]
}
}
},
"required": [
"title",
"brief",
"aspect",
"length_s",
"directions"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}