Overview

Overlap Required: Transitions work by overlapping the end of one element (preNodeId) with the start of another (postNodeId)
Maximum Duration: The transition duration cannot exceed the available overlap time between the two elements
Positioning: The transition's start time should align with the overlap period

Transition Duration Limits

The maximum duration for a transition is determined by:

maxDuration = min(
  availableEndTime_of_preNode,
  availableStartTime_of_postNode
)

If you set a duration longer than this, the transition may not render correctly.

Prop	Type	Required	Example	Value Range	Description
preNodeId	string	true	-	-	The unique identifier of the preceding element where the transition starts.
postNodeId	string	true	-	-	The unique identifier of the following element where the transition ends.
transitionType	string	true	-	directionalwarp, directionalwipe, Bounce, BowTieHorizontal, BowTieVertical, ButterflyWaveScrawler, CircleCrop, ColourDistance, CrazyParametricFun, Directional, DoomScreenTransition, Dreamy, DreamyZoom, GridFlip, InvertedPageCurl, LinearBlur, Mosaic, PolkaDotsCurtain, Radial, SimpleZoom, StereoViewer, Swirl, WaterDrop, ZoomInCircles, angular, burn, cannabisleaf, circle, colorphase, crosshatch, crosswarp, cube, displacement, doorway, fade, fadecolor, fadegrayscale, flyeye, heart, hexagonalize, kaleidoscope, luma, luminance_melt, morph, multiply_blend, pinwheel, pixelize, polar_function, ripple, rotate_scale_fade, squareswire, squeeze, swap, undulatingBurnOut, wind, windowblinds, windowslice, wipeDown, wipeLeft, wipeRight, wipeUp	The type of transition effect applied. Names are case-sensitive.

Important Notes:

The preNodeId and postNodeId must reference existing elements in the view array

Case Sensitivity: Transition type names are case-sensitive. Use exact names as listed above

Naming Convention: Some transitions use PascalCase (e.g., Bounce, CircleCrop), others use lowercase (e.g., fade, wipeLeft). Use the exact names as shown

Duration Limit: Ensure the transition duration doesn't exceed the overlap time between elements

The transition element itself doesn't need a trackIndex - it derives timing from the referenced elements

Example Use Cases:

A fade transition provides a classic cross-dissolve between two videos

wipeLeft creates a sliding wipe effect from right to left

Bounce adds a playful elastic bounce during the transition

Custom transitions like directionalwarp create distortion effects

Example: Video Transition

Two videos with a 2-second transition overlap:

transitionElement.json

{
"view": [
  {
    "id": "435862f1-2358-464d-b379-26f4b63b12e3",
    "type": "Video",
    "start": 0,
    "duration": 10.218542,
    "trackIndex": 0,
    "externalUrl": "https://example.com/video1.mp4",
    "ext": "mp4"
  },
  {
    "id": "2b82ffe3-7c6e-4d28-9c11-9e3de94c5a49",
    "type": "Video",
    "start": 8.218542,
    "duration": 15,
    "trackIndex": 0,
    "externalUrl": "https://example.com/video2.mp4",
    "ext": "mp4"
  }
],
"transition": [
  {
    "id": "52b20852-e260-41aa-afab-70c22e20f62b",
    "type": "Transition",
    "start": 8.218542,
    "duration": 2,
    "preNodeId": "435862f1-2358-464d-b379-26f4b63b12e3",
    "postNodeId": "2b82ffe3-7c6e-4d28-9c11-9e3de94c5a49",
    "transitionType": "directionalwarp"
  }
]
}