Direction
Where the kit is going, what is missing today, and the order the gaps will be closed in.
The aim is a motion library that people and agents both author in, the way a design system and a component library are shared by designers and engineers. A film should be a record you can read, diff, restyle and hand to a model. This page says what stands in the way.
The bet#
| Claim | What follows from it |
|---|---|
| Motion can be data | A scene is JSON and survives a round trip. It can be stored in a database, sent over a wire, diffed in review and played on a public page without running anyone's code. |
| Look, words and structure are three records | One film serves every brand. A design system is written once and dresses every film. A product record is the only thing a new customer has to supply. |
| Components carry the craft | Timing, easing and staging live inside components with a few knobs. An author picks FeatureScene and sets five props. They do not animate forty layers. |
| An edit is an operation | A change is as small as what changed. Agents send patches. People get undo, a history and a review for free. |
| Checks replace taste where they can | The compiler rejects what cannot work and names the fix. The audit measures overlap. What is left for a person is judgement, not proofreading. |
Where it stands#
| Part | State |
|---|---|
| Compiler, expressions, behaviors, poses | Working. Pure functions of time, no browser needed. |
| 89 components in 14 categories | Working. 81 are data. Not reviewed by a designer. |
| Design systems and product records | Working. 5 systems, 3 products, 90 combinations compile. |
| Browser renderer | Working. Draws any second of a scene in the DOM. |
| Patch edits, diff, change summary | Working. |
| Stage, arranger, audit, director | Working on three real recordings. Seats do not know where the face is. |
| Agent kit and CLI | Working. Copied by hand; no installer. |
| Video export | Missing. |
| Package on a registry | Missing. |
| Sound | Missing. |
What is missing, in order#
1. A renderer that writes a video file#
Today a scene only draws in a browser. The largest missing piece is a second renderer that turns the same compiled scene into frames for a video. The compiler already returns a function of time, so the renderer only has to draw what it is given at each frame. Until this exists the kit cannot ship a finished film.
2. A package people can install#
The kit is used from the Reelify repository. It needs a published package, a versioned registry address for kit/r/, and an add command that copies a component, system or film into a project the way component registries do.
3. Real video as a material#
An img can already play a clip in step with the scene. It cannot yet trim a clip, change its speed, reverse it, or cut it into tiles that move apart. Masks are limited to a circle, a spotlight and wipes. There are no blend modes. These are the pieces behind most product-film effects on real footage.
4. Sound#
A scene can name an audio file for a host to play. The kit does not place sounds on cues, duck music under speech or export a mix. A sound lane with the same timing rules as the picture is the plan.
5. A designer's pass over every component#
The components compile and move. Nobody whose job is motion has reviewed their timing, spacing and type. This is the difference between correct and good, and no check in the kit measures it.
6. Layout checks without a browser#
Overlap and off-frame checks need a mounted scene. A layout pass that runs anywhere would let an agent catch a collision in the same step that catches a wrong prop.
7. A stage that knows the speaker#
Seats on a talking video are fixed regions. They should come from where the face and hands are in each shot, so a piece never covers the person.
8. Wider evidence#
More runs per case, more models, longer films, and a score for how a film looks. See Benchmarks for what exists.
What will not change#
- A scene stays plain JSON. No functions in a spec, no code evaluated from one.
- A film never contains a colour value, a typeface or product copy.
- The library does not enforce layout. The arranger does, it reports every decision, and it can be turned off.
- Captions are a host's job. The stage publishes the lane they belong in.
- Every limit is written down next to the feature it limits.
Versions#
This is the 0.1 preview. Until 1.0 a release may rename a prop or a component, and the release notes will say which. From 1.0 a scene that compiles keeps compiling within a major version.