Templates

Curated allowlist of Synthesia templates supported by the video pipeline.

This file documents the 34 template IDs intentionally allowed in Fraya and explains how to choose among them. At runtime, the workflow still fetches template metadata (title, description, variables) from Synthesia itself and filters that live catalog against this curated set — see workflow.md.

Slide coding system

Template names encode their slide structure. Each character = one slide:

Code	Slide type	Used for
`A`	Avatar — talking-head	Intro, outro, speaker-led narration
`F`	Free text / summary	Synthesis, conclusion, open-ended explanation
`I`	Conceptual diagram	Visualisable models (pyramids, cycles, frameworks)
`T`	Two-column comparison	Do/don't, before/after, option A vs B
`1`–`8`	Numbered list (N items)	Principles, steps, rules
`Q`	Key statement (no script)	In-between framing, question, quotation

Reading examples:

A-4-A — intro avatar → 4-item list → closing avatar
A-3-1-1-1 — intro → 3-item overview → 3 elaboration slides (one per point)
A-I-I-I-F — intro → 3 diagram zones explored one by one → summary
A-Q-T-A — intro → framing question → do/don't comparison → outro

Selection rules

Match concept count — use the variants table below.
Match concept type — list vs. narrative vs. visual.
Use I slides only for genuinely visualisable models (Maslow's pyramid, Eisenhower Matrix, circular process). Do not use for random illustrations.
Short video (video_length = short) → pick a 2–3 slide template. Avoid detailed multi-step templates.
Q slides are for framing only — a question or statement with no voiceover. Not for content delivery.
Prefer F for content that requires synthesis or conclusion.
Avoid long 1-1-1-1-1 chains beyond 5 — they slow pacing. Use grouped templates instead.
For 6 or 8 points, use grouped templates (3+3, 4+4) rather than a single long list.

Approaches to explanation

Approach	Pattern	Use when
Point-based	`A-3-A`, `A-4-A`, `A-5-A`	Concept with N equal, short points
With detailing	`A-4-1-1-1-1`, `A-3-1-1-1`	Overview first, then each point elaborated
With summarization	`A-7-F`, `A-7-T`, `A-I-7-F`	List followed by synthesis or comparison
Visual-centred	`A-I-I-I-F`, `A-I-Q-F`	One diagram explored zone by zone
Grouped	`A-6-2-2-2-A`, `A-I-6-A`	6 or 8 items grouped for clarity

Template variants by concept count

Points	Avatar-based	List-based (with detail)	Image-based
1	`A-F-A` `A-Q-A`	`A-Q-F`	`A-I-Q-F` `A-I-F-A` `A-I-F`
2	`A-2-A`	`A-2-F` `A-2-1-1-A` `A-2-T-A` `A-Q-F-F-T-A`	`A-I-I-F` `A-I-T-F`
3	`A-3-A`	`A-3-F` `A-3-1-1-1` `A-F-1-1-1`	`A-I-I-I-F` `A-I-3-F`
4	`A-4-A`	`A-4-F` `A-4-1-1-1-1` `A-F-1-1-1-1`	`A-I-I-I-I-F` `A-I-4-F`
5	`A-5-A`	`A-5-F` `A-5-1-1-1-1-1` `A-F-1-1-1-1-1`	`A-I-I-I-I-I-F` `A-I-5-F`
6	`A-6-A`	`A-6-F` `A-6-2-2-2-A` `A-F-1-1-1-1-1-1`	`A-I-3-3-F` `A-I-6-A`
7	`A-7-A`	`A-7-1-1-1-1-1-1-1` `A-7-F` `A-7-T`	`A-I-7-A` `A-I-7-F`
8	`A-8-A`	`A-8-4-4-F` `A-8-2-2-2-2-A` `A-8-F`	`A-I-4-4-F` `A-I-8-A`

Available templates

Templates currently in the pipeline. TH = Talking Head group.

Code	Description
`A-F`	Single principle or idea — no enumeration
`A-F-A`	Short intro or conclusion — one key idea from the speaker
`A-F-A alt`	Same as above with an illustrative image
`A-Q-A`	Speaker uses a quote to support an idea (two variants)
`A-2-A`	Two related or contrasting ideas
`A-2-T-A`	Comparison of two points with side-by-side layout
`A-3-A`	Quick presentation of a concept with three elements
`A-3-1-1-1`	Three points, each with a short elaboration
`A-4-A`	Four-step process or framework (two variants)
`A-4-1-1-1-1`	Four elements, each explained in detail
`A-5-A`	Concise overview of five short points
`A-6-2-2-2-A`	Six elements — overview then 2 per slide in depth
`A-7-A`	Concise overview of seven short points
`A-8-A`	Concise overview of eight short points
`A-Q-F`	Concept with an emphasized key idea at the end
`A-Q-T-A` (do and don't)	Two groups (do/don't) — starts with a key question
`A-Q-F-F-T-A`	Two groups — overview of each, then side-by-side comparison
`A-I-Q-F`	Universal — one image/diagram fully represents the concept
`A-I-I-F`	Two focal areas on one diagram
`A-I-I-I-F`	Three zones/layers of one diagram
`A-I-I-I-I-F`	Four focus areas of one model
`A-I-I-I-I-I-F`	Five focus areas of one model
`A-I-6-A`	Six-element model — diagram + numbered list
`A-I-7-F`	Seven-element model — diagram + numbered list + summary
`A-I-8-A`	Eight-element model — diagram + numbered list
TH `A-Q-A-F`	Avatar narrates and summarizes at the end
TH `A-2-I-F`	Avatar with two main ideas, illustration, summary
TH `A-3-A`	Avatar with a list of 3 key ideas
TH `A-3-4-A`	Avatar with 3-item overview and 4-item deep dive
TH `A-4-A`	Avatar with a list of 4 key ideas
TH `A-4-3-A`	Avatar with 4-item overview and 3-item deep dive
TH `A-2-4-F`	Avatar with 2 main topics, 4-item breakdown, summary

Full UUID reference

Template	UUID
`A-F`	`0c471c30-f3fe-432b-9fae-642b096238c1`
`A-F-A`	`3b087ccf-e6e7-4abd-a7bf-f7f6d0cd929d`
`A-F-A alt`	`dfe0a3eb-5dd2-4390-9f63-a3c82de5d2e2`
`A-Q-A`	`17e90580-4d21-4a7a-ac11-302769c6af72`
`A-Q-A alt`	`f339a435-a029-49c0-b9e9-62aff359377b`
`A-Q-F`	`bce8d90b-1763-4760-8a8a-b1e17d6a76c5`
`A-2-A`	`a69a1847-5a21-4851-a055-0004c2f77d6c`
`A-2-T-A`	`738d5c0e-5e7e-450c-a383-5faee36b6f6d`
`A-Q-T-A (do and don't)`	`13ab1dd8-cbb8-4fa3-bee6-94403ee2ba5f`
`A-Q-F-F-T-A`	`a5dc9714-a4bf-4e0c-a295-6f9379642202`
`A-3-A`	`55841701-44b2-400a-92d1-a934fd89d38b`
`A-3-1-1-1`	`3aeef876-0d31-48ca-a4e5-b62e36bc8d04`
`A-4-A`	`9c3c133c-57a3-4540-a860-cfeb3eeb39bd`
`A-4-A alt`	`0a432793-73b3-47dd-bed5-5f4a73d3b2d3`
`A-4-1-1-1-1`	`b6924930-823d-4e11-afea-7380997e97d3`
`A-5-A`	`340086a0-4cd0-498f-a441-41ea4b225cb6`
`A-6-2-2-2-A`	`ca2bbd8e-2820-497c-9d75-c23ea4300375`
`A-7-A`	`118eed92-5d98-49e3-9f20-e1b1d69f3169`
`A-8-A`	`e534af2d-b12e-4b1b-bdda-e173f2a091d4`
`A-I-Q-F`	`e4d32108-a318-4fca-9afe-c64de3c83678`
`A-I-I-F`	`7f1ac6a9-6fd3-4181-87f1-328f1abe4f70`
`A-I-I-I-F`	`69b3cb22-d879-47cf-9c1b-232d0234fc43`
`A-I-I-I-I-F`	`5879419a-68e1-43ec-af62-df119bf3233d`
`A-I-I-I-I-I-F`	`0faa863d-3c12-425f-b8bf-7febe657352f`
`A-I-6-A`	`af85c7d4-8115-4c01-8bbf-a84a180817bd`
`A-I-7-F`	`20887d7e-c92b-49eb-9198-47983f71f7b3`
`A-I-8-A`	`c8a808d9-cfd7-43de-bd50-f749ad0c48b3`
TH `A-Q-A-F`	`9c23e3c3-401b-4373-9ca2-e15b669974a3`
TH `A-2-I-F`	`ae206c3a-b714-4868-b124-4872b2d6e3e7`
TH `A-3-A`	`e5d0bb60-c987-4bbb-855f-c887fdb5b94f`
TH `A-3-4-A`	`aca46fdf-30ab-4bc4-9fb7-9681f46f75e1`
TH `A-4-A`	`356f2168-15ab-4798-bf91-c4da8a6f24a9`
TH `A-4-3-A`	`2ad00232-a3d8-4b08-92e1-428f0e2cae4b`
TH `A-2-4-F`	`2a2a9cac-acd9-477c-81aa-729bf7da18cf`