Scene Intents

Intents are semantic labels for scenes. They tell the compiler what the scene is doing in the narrative, which influences default entrance selection, palette variation, and spacing.

Available Intents

Intent Typical Entrance When to Use
problem fade Establishing a challenge or pain point
shift push Pivoting the narrative ("But what if...")
reveal pop Unveiling something new
proof rise Showing evidence — numbers, metrics, testimonials
authority scale Asserting credibility
contrast push Before/after comparison
resolve fade Wrapping up, concluding
cta pop Call to action

Setting Intent

text
Scene "Revenue" intent: proof
  layout: grid 2x2
  show number "24,300"
    label: "Active Users"

Automatic Inference

If you omit intent:, the compiler infers it from scene content. A scene named "CTA" or containing action-oriented text gets cta intent. A scene with numbers and metrics gets proof. Inference is best-effort — when it matters, set the intent explicitly.

Narrative Arcs

Intents support common narrative patterns:

Problem → Solution → CTA:

text
Scene "Pain" intent: problem
Scene "Answer" intent: shift
Scene "Action" intent: cta

Problem → Proof → Authority → CTA:

text
Scene "Challenge" intent: problem
Scene "Results" intent: proof
Scene "Credibility" intent: authority
Scene "Next Step" intent: cta

Intents do not enforce a specific order — you can use any intent on any scene. They are hints, not constraints.

Next Steps