Context Engineering for Visual Storytelling
FlowBoard is a node-based tool for adapting scripts and screenplays into storyboards and graphic novel panels. It breaks stories into discrete, reusable components—characters, settings, cameras, actions—that wire together to form scenes.
The system compiles these nodes into structured prompts and passes them to image generation models. The goal is to make visual narrative development more systematic and less repetitive.
The Interface
The interface is inspired by tools like Blender's compositor and TouchDesigner, but focused specifically on narrative image generation. Nodes represent story elements; wires define how they connect.
A scene from "The Red Ferrari Night" — nodes for characters, settings, shots, and actions wire into output nodes that generate images.
Assets: Character, Setting, Prop, Style, Extras — define the visual elements
Modifiers: Shot, Outfit, Camera — control framing and appearance variations
Scene: Action, Text, Negative, Parameters, Time Period — describe what happens and generation settings
Output: Output, Page, Comp — generate images and assemble layouts
Animation: Transform, Timeline — position, scale, and sequence for motion
How It Works
Each output node collects information from connected nodes and assembles a prompt. The prompt includes character descriptions, setting details, camera parameters, the action being performed, and style direction.
The graph flows left to right, like a timeline. A character defined upstream can be modified as they move downstream—change their outfit, age them, shift their emotional state. The core identity persists while the details evolve.
Outputs from one stage can feed as references into the next. This lets you build continuity shot-by-shot: the result of Scene 1 informs the generation of Scene 2. The character grows with the story.
An Intercept node can be placed anywhere in the flow. It shows what a particular branch contributes to the final prompt—useful for debugging or understanding the system. It also lets you inject details that guide that branch's contribution, adding specificity without cluttering the source nodes.
A single character definition branches into multiple outputs with different outfits and contexts. The character's essence stays consistent while their appearance adapts to each scene.
Capabilities
FlowBoard includes features for text overlays, composition, and motion. These are still being developed but the foundation is in place.
A more complex setup: word balloon nodes for dialogue, transform nodes for positioning, timeline for animation, and composition for layering.
Hybrid Workflow
Any node can accept a reference image. This allows for hybrid workflows—use a 3D blockout, a rough sketch, or a photograph as a starting point.
The example shows a simple 3D scene used as a reference. The generation model interprets the spatial layout while applying the style and details from the prompt.
Generated images from earlier scenes can also be fed back as references for later scenes, helping maintain visual continuity.
Composition
For graphic novel work, individual panels need to be assembled into pages. FlowBoard includes Page and Comp nodes for this purpose. Reference images flow through transform nodes (for positioning and scaling) into page layout nodes.
Multiple scenes being transformed and composed into page layouts. The sidebar shows all available node types.
Example Output
These images are from a test project adapting a chapter from "You Think You're the Black Cat" — a scene where 7-year-old Mason is taken by his father Marcus to an underground club in late 1970s Atlanta. Mason doesn't know why they're there; Marcus seems to know everyone, and it's clearly not his first visit.
Marcus and Mason approach The Warehouse. The Bouncer waits at the door.
Mason at the bar with his Coca-Cola.
The Bouncer greets Mason.
Backstage. The Lead Singer towels off after the set.
After the talk. The Singer walks away; Mason holds the guitar pick.
"You think you're the black cat... but I'm the one sleeping in the jungle."
WIDE SHOT establishing a modest Grant Park Victorian home. Warm yellow light spills from windows onto a manicured lawn. A single porch light illuminates the front steps.
SOUND: Distant rumble of an approaching engine, growing louder.
MEDIUM SHOT from the porch. MASON (7), small for his age, stands at the screen door peering out. His GRANDMOTHER's hand rests on his shoulder.
LOW ANGLE from the street as headlights sweep across frame. A 1979 FERRARI 308 GTS, impossibly red, glides to a stop at the curb. The engine burbles, then dies.
CLOSE-UP on Mason's face. Eyes wide. The red glow of taillights reflects in his pupils.
MEDIUM SHOT as MARCUS (late 20s) unfolds himself from the driver's seat. He moves with casual confidence, adjusting his collar, flashing a grin toward the porch.
REVERSE SHOT — Mason breaks from his grandmother's grip, and bounds down the porch steps.
LOW TRACKING SHOT following Mason's sneakers across the grass, stopping at the Ferrari's passenger door.
TWO-SHOT — Marcus leans across, pushes the door open from inside. The leather interior glows amber under the dome light.
INSERT — Mason's small hand touches the leather seat. It's still warm.
INTERIOR MEDIUM from the backseat position. Mason sits in the passenger seat, legs too short to reach the floor. His bare legs stick slightly to the leather.
POV SHOT through the windshield — Peachtree Street at night. Neon signs blur past. Streetlights strobe rhythmically.
CLOSE-UP on Marcus's hand shifting gears. Gold watch catches light.
CLOSE-UP on Mason — vibration of the engine travels through his small body. A half-smile.
WIDE SHOT establishing the club. A converted warehouse, nondescript except for a hand-painted sign and a cluster of SMOKERS near the entrance. Motorcycles and beaters line the curb. The Ferrari looks alien among them.
MEDIUM SHOT — Marcus and Mason approach the entrance. A massive BOUNCER blocks the door, arms folded.
TWO-SHOT — The Bouncer's stern expression breaks into recognition. He extends a hand the size of a baseball mitt.
INSERT — Mason's tiny hand meets the Bouncer's palm in a high-five.
WIDE SHOT — A wall of smoke, bodies, and sound. The club is packed. A BAND plays on a low stage at the far end, half-visible through the haze. Christmas lights strung haphazardly provide most of the illumination.
LOW ANGLE TRACKING — We follow Marcus's boots as he moves through the crowd. People part for him. Nods of recognition. Hands clap his shoulder.
MEDIUM SHOT — Marcus hoists Mason onto his shoulders in one fluid motion.
POV SHOT (Mason's height now) — The room transforms. He can see over heads now. The stage is visible. The LEAD SINGER writhes at the microphone, bathed in red light.
MEDIUM SHOT — Marcus arrives at the bar, Mason still on his shoulders. The BARTENDER, a weathered woman with kind eyes, is already reaching below the counter.
INSERT — A plastic cup slides across the bar. Coca-Cola. No ice.
CLOSE-UP — Mason takes the cup. Nods seriously, as if concluding a business transaction.
MEDIUM SHOT — The band has finished their set. Equipment is being broken down. The LEAD SINGER sits on an amp, toweling sweat from his face. His eyes are glassy, unfocused.
TWO-SHOT — Marcus approaches with Mason. The Singer looks up.
MARCUS: This is my kid. Gonna rule the world someday.
REVERSE CLOSE-UP — The Singer studies Mason. His gaze sharpens momentarily through the chemical haze.
The Singer kneels. Eye level with the boy.
INSERT — The Singer's calloused finger taps Mason's chest, over his heart.
LEAD SINGER: You've got an old soul.
LEAD SINGER (CONT'D): You think you're the black cat... but I'm the one sleeping in the jungle.
INSERT — The Singer presses a GUITAR PICK into Mason's palm. Closes the small fingers around it.
WIDE SHOT — The Singer rises, disappears into the backstage shadows. Mason stands frozen, fist closed around the pick.
SLOW PUSH on Mason's face as the ambient noise of the club fades. Just the boy. Just the weight of words he won't understand for years.
FADE TO BLACK.
| eraPreset | 1970s |
| region | American South |
| description | Late 1970s Atlanta, Georgia. The tail end of disco, the rise of punk and new wave. A city of contradictions—old Southern money meets new hustler energy. Pre-crack epidemic, but the underground economy thrives. |
| Noir Graphic Novel | High contrast noir aesthetic. Deep blacks, blown-out highlights. Warm ambers and deep reds dominate, with sodium-vapor yellows. Occasional cool blue from neon. 1970s film grain texture—soft but not degraded. Smoke catches and diffuses all light sources. Practical lighting dominates. |
| Mason (Child) | 7-year-old white boy, small for his age, blue-green eyes, freckles across nose and cheeks. Dutch-American father, British-Irish mother. Sand-colored light brown hair, slightly unkempt. Wearing faded gray AC/DC t-shirt with lightning bolt logo under open denim jacket, corduroy shorts, worn high-top canvas Converse sneakers. Hair is shaggy, ear-length. |
| Marcus | Late 20s white man, fair-skinned, light complexion, Dutch-American descent, Mason's father. Sandy brown hair, strong jaw, blue eyes. Handsome, confident, moves like he owns every room. A drug dealer who operates between worlds—part outlaw, part gentleman. Wearing fitted leather jacket over silk shirt, dark slacks, polished boots. Gold wristwatch. |
| Grandmother | 60s white woman of British-Irish descent, Mason's maternal grandmother. Graying auburn hair pinned back. Proper, worried, trying to maintain order in chaos. Wearing floral housedress, cardigan, sensible shoes. |
| Bouncer | 30s Black man, massive, intimidating to strangers but familiar with Marcus's crew. Hands like baseball mitts. Wearing black t-shirt straining at biceps, jeans, work boots. Tattoos visible on forearms. |
| Bartender | 40s white woman, weathered but kind. Has seen everything. Keeps Coca-Cola ready for kids who come through. Wearing tank top, denim vest, multiple rings, cigarette tucked behind ear. |
| Lead Singer | Late 20s white man, gaunt, intense, chemically altered. A prophet in the body of a rock musician. Eyes that focus and unfocus. Wearing sweat-soaked white t-shirt, tight jeans, bare feet. Leather cuff on wrist. Eyeliner smudged. |
| Grandparents' Victorian | Grant Park, Atlanta. Modest but well-maintained Victorian home. Warm yellow light spills from windows onto manicured lawn. Single porch light illuminates front steps. Screen door. Porch swing. |
| Ferrari Interior | Cherry red Italian sports car, tan leather seats, period-correct dash with analog gauges. Warm dome light. Cramped but luxurious. Smells of leather and engine heat. |
| The Point Exterior | Converted warehouse nightclub. Hand-painted sign over door. Dim exterior lighting. Gravel parking area with motorcycles and beaters. Industrial, nondescript, deliberately anonymous. |
| The Point Interior | Low ceilings thick with cigarette smoke. Christmas lights strung haphazardly provide ambient glow. Low stage at far end. Packed with bodies. Sticky floors. Dark except for stage lighting and string lights. |
| The Point Backstage | Behind the low stage. Marshall amps, cables, equipment cases stacked. Dim work lights. Concrete floor. Intimate, claustrophobic. The detritus of performance. |
| 1979 Ferrari 308 GTS | Cherry red, gleaming Italian sports car. The car is almost a character—representing Marcus's dangerous success. Alien object in Mason's normal world. |
| Guitar Pick | Worn, standard shape, dark colored. Given by the Singer. Talisman Mason will carry for years—physical anchor for the prophecy. |
| Coca-Cola Cup | Simple plastic cup, no ice. Served by the bartender without being asked. Signals Mason's established place in this world. |
Work in Progress
Maintaining consistent character appearance across multiple generations is one of the harder problems in this space. FlowBoard helps by keeping character definitions centralized and allowing reference images to be passed through the pipeline.
It's not perfect. Age, clothing details, and facial features can still drift between generations, especially in complex scenes. The current approach involves detailed descriptions, specific wardrobe callouts, and using successful generations as references for subsequent shots.
This is an area of active experimentation.
Technical
FlowBoard connects to image generation APIs through adapters. Currently implemented:
The adapter abstraction means the story structure—all the nodes and connections—stays the same when switching between models. Different models have different strengths; being able to swap them without rebuilding the scene is useful for comparison and iteration.
FlowBoard is a work in progress. The core node system, generation pipeline, and basic composition features are functional. Animation and more advanced composition are partially implemented. The interface needs polish.
The intended audience is independent filmmakers and content creators—people working on passion projects where budget and time are limiting factors. This isn't meant to replace the experience and craft that professionals bring to storyboarding and pre-visualization. It's meant to help smaller teams move faster and explore more ideas before committing resources.