Reelify Motion Kit 0.1 preview
Docs/Guide

Introduction

What Reelify Motion Kit is, how its four layers fit together, and what it can and cannot do today.

Reelify Motion Kit is a library for motion graphics written as data. A scene is one JSON record: a tree of nodes, each with props, a list of behaviors and a start time. compile(spec, registry) checks the record and returns a function of time. A renderer draws that function at any second. The same record format describes a four second title card and a thirty second product film.

The kit was built for two authors at once: a person with an editor, and an agent that writes JSON. Both use the same components, the same checks and the same edit operations.

A scene#

This is a complete scene. It uses one component (KineticLine), two elements (box, text), two behaviors (stagger, enter), one surface (chip) and one named curve (bouncy). It contains no colour value and no typeface.

A component, then a row of four boxes that start one second in and arrive 0.12 seconds apart.

Units are pixels on the frame, seconds and degrees. The root box is the frame. Scenes covers the record in full.

The four layers#

Each layer is made from the one below it. Use the highest layer that does the job.

LayerWhat it holdsUse it for
ScenesThe record itself: size, duration, root, cues, signals and the kit fields. A film is a scene whose root holds a Sequence.Anything you ship. See Scenes and Films.
Elements and components5 elements (box, text, shape, icon, img) and 89 components built from them. 81 components are plain data. 8 are built by a short function.Pick a component and set its props. Compose elements when no component fits. See Components and Custom components.
Behaviors20 behaviors. Each does one job (enter, exit, stagger, camera, drive) and is a pure function of time.Motion on any node. A node can carry several. See Behaviors.
CoreCurves and springs, poses, "=expr" arithmetic, signals.Motion that no behavior covers. See Expressions.

Two more things sit beside the layers. A design system (a config record) supplies colours, typefaces, surfaces and spring curves. A product record supplies words as tokens. Neither is part of a film.

What is different#

Data, not code#

A scene survives a JSON round trip. Expressions such as "=cos(index/count*tau)*240" are parsed by the kit and are never evaluated as program code, so a scene can be stored, sent and played on a public page. The 81 data components are written in the same format a scene uses to define its own.

Look and words are separate from the film#

A film says "accent", "card", "punchy" and "$tagline". A design system gives the first three their values. A product record gives the last its text. Six example films, five design systems and three products give 90 combinations. All 90 compile with no problems. See Design systems.

Edits are operations#

A change to a film is a short list of add, replace, remove and move operations with JSON Pointer paths. The list is applied whole or not at all. Everything the list does not name is untouched. See Editing.

Checks name the valid options#

compile returns problems (must fix) and notes (will play, probably not what was meant). Each message names the place and the values that would have been accepted:

text
box #b1.align: "middle" is not one of start, center, end, stretch
text #t2 enter.from: no pose named "rize" (use fade, rise, drop, slide-left, slide-right, pop, …)

Nothing in the check touches a screen. An agent can verify its work without rendering a frame.

What is in the box#

The kit also ships 12 surfaces, 5 design systems, 5 skills for editing talking videos, a CLI and an agent kit generated from the registry. Try a scene in the scene playground or a whole film in the film playground.

Status and limits#

  • The only renderer is the browser (DOM): mount(host, compiled, fonts, assets).seek(t). There is no export to a video file yet.
  • The kit is not published to a package registry yet. It is used from the Reelify repository. See Quick start.
  • There is no sound track. A scene can name an audio asset for a host to play, and the kit does not mix or export it.
  • Video media cannot be sliced into tiles, trimmed, reversed or played at another speed.
  • Masks are limited to a circle (aperture), a spotlight (spotX, spotY, spotR) and wipes (the clipT, clipR, clipB, clipL pose channels). There are no blend modes.
  • Layout measurement needs a browser. The compile check runs anywhere. Overlap and off-frame checks run on a mounted scene.
  • The components have not had a designer's review.
  • Evaluation so far is one or two runs per case. See Benchmarks.

Direction lists what is missing in priority order.

Reelify Motion Kit 0.1 preview. Built 2026-11-21.llms.txt · SKILL.md · 109 pages