StageFlow: A 3D Blueprint Stage for Camera Blocking and Choreography
A web studio that turns a film scene into a 3D diorama: reference video on one side, actors, cameras and lenses on the other, blocking written in plain YAML.
Project intro
If you have ever wondered how a film scene was actually blocked — where the actors stood, where the camera sat, which lens was on it — storyboards and stills only tell half the story. StageFlow is a free web studio that plays your reference video next to an interactive 3D blueprint stage, so you can see the whole scene from above: performers as directional mannequins with footprints, cameras as real rigs on tripods, dolly rails or curved tracks.
The camera is drawn the way a real one behaves: a rectangular film-gate cone in 16:9 or 2.39:1, full-frame prime lenses from 24mm to 85mm, a focus plane you can slide through the scene, and a one-key bokeh blur that shows the shot through the camera's own eye. Scrub millisecond by millisecond or step one frame at a time; pause and the frozen staging hands over to free 3D orbit controls so you can walk around it.
You write the blocking as code, not by dragging gizmos: a clean YAML score says who stands where, who they face, and how the camera moves, and the studio turns it into a 60fps timeline. It ships with seven factory scene studies, four themes, a three-column studio with a live YAML editor, and one-click MP4 export of the camera view or the diorama, straight from the browser.
It runs entirely in the browser — open the live studio and go — or you can clone it and run it locally with Node.js 20 or newer. The author built it with Gemini inside Google Antigravity, and the README carries a plain warning that it was an exploratory build, so you may hit rough edges. It has 39 stars and 6 forks in its first eight days, and the code is MIT licensed.
Actions
Tech stack
Project info
- Project category
- Design & Creative
- Project status
- Online
- Collaboration intent
- None