the-nexus/docs/media/README.md

Media Production — Veo/Flow Prototypes

Issue #681: [MEDIA] Veo/Flow flythrough prototypes for The Nexus and Timmy.

Contents

• veo-storyboard.md — Full storyboard for 5 clips with shot sequences, prompts, and design focus areas
• clip-metadata.json — Durable metadata for each clip (prompts, model, outputs, insights)

Clips Overview

ID	Title	Audience	Purpose
clip-001	First Light	PUBLIC	The Nexus reveal teaser
clip-002	Between Worlds	INTERNAL	Portal activation UX study
clip-003	The Guardian's View	PUBLIC	Timmy's presence promo
clip-004	The Void Between	INTERNAL	Ambient environment study
clip-005	Command Center	INTERNAL	Terminal UI readability

How to Generate

Via Flow (labs.google/flow)

1. Open veo-storyboard.md, copy the prompt for your clip
2. Go to labs.google/flow
3. Paste the prompt, select Veo 3.1
4. Generate (8-second clips)
5. Download output, update clip-metadata.json with output path and findings

Via Gemini App

1. Type "generate a video of [prompt text]" in Gemini
2. Uses Veo 3.1 Fast (slightly lower quality, faster)
3. Good for quick iteration on prompts

Via API (programmatic)

from google import genai
client = genai.Client()

# See: ai.google.dev/gemini-api/docs/video
response = client.models.generate_content(
    model="veo-3.1",
    contents="[prompt from storyboard]"
)

After Generation

For each clip:

1. Save output file to outputs/clip-XXX.mp4
2. Update clip-metadata.json:
   • Add output file path to output_files[]
   • Fill in design_insights.findings with observations
   • Add threejs_changes_suggested if the clip reveals needed changes
3. Share internal clips with the team for design review
4. Use public clips in README, social media, project communication

Design Insight Workflow

Each clip has specific questions it's designed to answer:

clip-001 (First Light)

• Scale perception: platform vs. portals vs. terminal
• Color hierarchy: teal primary, purple secondary, gold accent
• Camera movement: cinematic or disorienting?

clip-002 (Between Worlds)

• Activation distance: when does interaction become available?
• Transition feel: travel or teleportation?
• Overlay readability against portal glow

clip-003 (The Guardian's View)

• Agent presence: alive or decorative?
• Crystal hologram readability
• Wide shot: world or tech demo?

clip-004 (The Void Between)

• Void atmosphere: alive or empty?
• Particle systems: enhance or distract?
• Lighting hierarchy clarity

clip-005 (Command Center)

• Text readability at 1080p
• Color-coded panel hierarchy
• Scan-line effect: retro or futuristic?

Constraints

• 8-second clips max (Veo/Flow limitation)
• Queued generation (not instant)
• Content policies apply
• Ultra tier gets highest rate limits